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PREFACE 


MANUAL OBJECTIVES 


The purpose of this manual is to provide all the information needed to 
use the I/O device drivers supplied as part of the Micro/RSX system. 


INTENDED AUDIENCE 


This manual is for experienced Micro/RSX programmers who want to take 
advantage of the time or space savings that result from direct use of 
the I/O drivers. Readers should be familiar with the information 
contained in the RSX-11M/M-PLUS and Micro/RSX Executive Reference 
Manual, have some experience using the Task Builder and either 
MACRO-11 or FORTRAN languages, and be familiar with the manuals 
describing their use. 


STRUCTURE OF THE MANUAL 


Chapter 1 provides an overview of Micro/RSX input/output operations. 
It introduces you to the use of logical unit numbers, directive 
parameter blocks, event flags, macro calls, and so on; includes 
discussions of the standard 1/0 functions common to a variety of 
devices; and summarizes standard error and status conditions relating 
to completion of I/O requests. 


Chapters 2 through 7 describe the use of all device drivers supported 
by Micro/RSX. Each of these chapters is structured in similar fashion 
and focuses on the following basic elements: 


e The device, including information on physical characteristics 
such as speed, capacity, access, and usage 


@® The standard functions” that the devices support and 
descriptions of device-specific functions 


@® The special characters, carriage control codes, and functional 
characteristics, if relevant 


e The error and status conditions that the driver returns. on 
acceptance or rejection of I/O requests 


@ Programming hints 


Appendixes A through C provide quick reference material on I/0 
functions and status codes. 
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PREFACE 


ASSOCIATED MANUALS 
The following Micro/RSX manuals may be useful: 


@e RSX-11M/M-PLUS and Micro/RSX Executive Reference Manual 


er 


@e RSX-11M/M-PLUS and Micro/RSX Task Builder Manual 


e PDP-11 MACRO-11 Language Reference Manual 


SE 


@e Micro/RSX Release Notes 


In addition, documentation for programming in any of the MicroPDP-11l 
languages may be helpful. 


CONVENTIONS USED IN THIS MANUAL 


The following conventions are observed in this manual. 
2 


Convention Meaning 
{ ] Square brackets; enclose optional syntax 
{ } Braces; indicate that one of the enclosed items 


must be selected. 


orate Horizontal ellipsis; indicates that parameters 
have been omitted. In QIO macro calls in this 
manual, indicates that standard QIO parameters 
have been omitted. 


er Consecutive commas; used in coding examples’ to 
indicate null arguments. You may omit commas that 
indicate null trailing optional arguments. 


Furthermore, except in MACRO-11 coding examples, all numbers are 
assumed to be decimal unless otherwise specified. In MACRO-11l coding 
examples, the reverse is true: all numbers are considered to be octal 
unless followed by a decimal point (which indicates a decimal number). 


Finally, in FORTRAN subroutine models, parameters that begin with the 
letters i through n prefixes, the i form indicates the name of an 
array and the n form specifies the size of the array. 


All integer arrays and variables are assumed to occupy one storage 
word per variable (that is, INTEGER2) and all real arrays and 
variables are assumed to occupy two storage words per variable (that 
is, REAL4). 


SUMMARY OF TECHNICAL CHANGES 


This revision of the Micro/RSX I/O Drivers Reference Manual reflects 
the following software technical changes and additions: 


e A new I/O function, IO.EIO (Extended I/0), which contains new 
subfunctions, has been added to the full-duplex terminal 
driver. 


e Support for the DZQl11 4-line terminal multiplexer, a DzZVll 
replacement, has been added to the full-duplex terminal 
driver. 


e Support of the full-duplex terminal driver has been extended 
to allow its use as a Network Command Terminal. 


e Support for the RC25 and RD52 disks, the KDA5O controller, and 
the RQDX2 controller (an MSCP RQDX1 replacement controller) 
has been added to the disk drivers. 


e Support for the TK25 and TK50 magnetic tape drives has’ been 
added to the tape drivers. 


In addition to these changes, Chapters 1 and 2 have been reorganized 
to make the information more easily accessible to the _ reader. 
Appendixes A and B have been updated to reflect the new I/O functions, 
subfunctions, and error codes that have been included. 


xi 


CHAPTER 1 


MICRO/RSX INPUT/OUTPUT 


1.1 OVERVIEW OF MICRO/RSX 1/0 


This manual describes all of the Micro/RSX input/output (I/0) device 
drivers supported by the system. It gives driver characteristics, 
functions, error conditions, and provides programming hints for each. 
The drivers described in this manual are supplied by Digital Equipment 
Corporation as part of the system software to support associated 
devices. Devices not mentioned in this manual can be added to basic 
system configurations, but users must develop and maintain their own 
drivers for these devices. (See the RSX-11M-PLUS Guide to Writing an 
I/O Driver.) 


The following loadable drivers are always loaded in the Micro/RSX 
system: 


1. Terminal Driver (TTDRV.TSK) 

2. Virtual Terminal Driver (VTDRV.TSK) 

3. Winchester Fixed-Disk/ 5.25-inch Diskette Driver (DUDRV.TSK) 

4. Reconfiguration Driver (RDDRV.TSK) 

5. Null Device Driver (NLDRV.TSK) 
The following loadable drivers are for the optional hardware devices 
and are not pre-loaded into the Micro/RSX system. These drivers are 
loaded automatically at system start-up, if the Autoconfigure task 
finds the associated device connected to the system. 

1. Removable Cartridge Disk Driver (DLDRV.TSK) 

2. TU58 Cartridge Tape Driver (DDDRV.TSK) 

3. 8-Inch Diskette Driver (DYDRV.TSK) 

4. Line Printer Driver (LPDRV.TSK) 

5. TK25 Cartridge Tape Driver (MSDRV.TSK) 

6. TK50 Cartridge Tape Driver (MUDRV.TSK) 
Device drivers are operating system programs that communicate directly 
with the hardware devices connected to your microcomputer. A driver 
is the dividing line between Micro/RSX Executive system software and 
the hardware devices. Each driver recognizes specific types of 
hardware devices. This means each driver knows how to interpret the 


unique control signals sent by a particular hardware device and is 
programmed to notify the Executive when the device is ready to send or 
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receive data. At the operating system end, the Executive receives I/0 
requests from tasks and queues them as they are issued. These 
requests are then issued to the driver according to the relative 
priorities of the tasks that issued them. Tasks issue I/O requests in 
the form of macros called Queue I/O (QIOS$) system macros. 


QIOSs are used for MACRO-11 I/0 programming at the driver level with 
all I/O requests sent directly to the Executive QIOS processor. 
MACRO-11 I/O programming can also be done at a higher level by using 
either the File Control Services or Record Management Services. These 
services provide a high-level MACRO-11 I/0 language user interface 
that generates the appropriate QIOs for a requested I/O operation. 


All of the I/O services described in this manual are requested by the 
user in the form of QIO$ system macros. A function code included in 
the QIOS$ macro indicates the particular input or output operation to 
be performed. I/0 functions can be used to request such operations as 
the following: 
@e Attaching or detaching a physical device unit for a_ task's 
exclusive use 


@e Reading or writing a logical or virtual block of data 
e Canceling a task's I/O requests 


Although input/output operations under Micro/RSX are extremely 
flexible and are as device- and function-independent as possible, 
there are device-specific input/output operations, such as 
disconnecting a terminal on a remote line and reading or writing a 
physical block, that can also be specified with QIOS macros. 


Device independence is achieved by associating logical units with 
physical units. Programs issue I/0 requests to logical units that 
have been previously associated with particular physical device units. 
Each program or task is able to establish its own correspondence 
between physical device units and logical unit numbers (LUNs). 


1.2 PHYSICAL, LOGICAL, AND VIRTUAL 1/0 


There are three possible modes in which an I/O transfer can take 
Place: physical, logical, and virtual. 


Physical I/O concerns reading and writing data in the actual physical 
units accepted by the hardware (for example, sectors on a disk). For 
most devices, physical I/O is identical to logical I/0 in that a 
256-word (512-byte) logical block exactly matches the size of a sector 
on disk. In the case of the RX02 flexible disk recorded in double 
density, the physical and logical blocks are different. Data for the 
RX02 is recorded in physical sectors of 128 words’ each. Therefore, 
logical blocks for the RX02 are made up of two physical sectors each. 


Logical I/O concerns reading and writing data in blocks that are 
convenient for the operating system. In most cases, logical blocks 
map directly into physical blocks. For block-structured devices (for 
example, disks), logical blocks are numbered beginning at 0. For 
non-block-structured devices (for example, terminals), logical blocks 
are not addressable. 
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Virtual I/O concerns reading and writing data to open files. In _ this 
case, the Executive maps virtual blocks into logical blocks. For 
file-structured devices (disks or TU58 Tape), virtual blocks are _ the 
same size as logical blocks and are numbered starting from one (1); 
they are relative to the file rather than to the device. For 
non-file-structured devices, the mapping from virtual block to logical 
block is direct. 


1.3 LOGICAL UNIT 


This section describes the construction of the logical unit table and 
the use of logical unit numbers. 


1.3.1 Logical Unit Number 


A logical unit number (LUN), is a number associated with a physical 
device unit during I/0 operations. For example, LUN 1 might be 
associated with one of the terminals in the system, LUNs 2, 3, 4, and 
5 with TU58 tape drives, and LUNs 6, 7, and 8 with disk units. The 
association is a dynamic one; each task running in the system can 
establish its own correspondence between LUNs and physical device 
units, and can change any LUN to physical device-unit association at 
almost any time. The flexibility of this association contributes 
heavily to system device independence. 


A logical unit number is a short name that represents a logical-unit 
to physical-device-unit association. Once the association has been 
made, the LUN provides a direct and efficient mapping to the physical 
device unit, and eliminates the necessity to search the device tables 
whenever the system encounters a reference to a physical device unit. 


You should remember that, although a LUN to physical device-unit 
association can be changed at any time, reassignment of a LUN at run 
time causes pending I/O requests for the previous LUN assignment to be 
canceled. It is your responsibility to verify that all outstanding 
I/O requests for a LUN have been serviced before that LUN is 
associated with another physical device unit. 


1.3.2 Logical Unit Table 


There is one Logical Unit Table (LUT) for each task running in an 
Micro/RSX operating system. The task header contains this table as a 
variable-length block. Each LUT contains enough 2-word entries for 
the number of logical units. You specify the number of logical units 
in the Task Builder by the "UNITS=" option when you build your task. 


The first word of each 2-word entry contains a pointer to the Unit 
Control Block that represents the physical device unit currently 
associated with that LUN. This linkage may be indirect; that is, you 
may force redirection of references from one unit to another unit with 
the DCL command ASSIGN/REDIRECT. The second word of each 2-word entry 
is reserved for a pointer to the window block of the task that has a 
file open and mounted. The window block contains pointers to areas on 
the file that are accessed by the task. 
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Whenever your task issues an I/0 request, the system matches’ the 
appropriate physical device unit (by using the Unit and Device Control 
Blocks and other structures) to the LUN that the call specifies. The 
system does this by indexing into the LUT by the LUN number. Thus, if 
the call specifies 6 as the LUN, the system accesses the sixth 2-word 
entry in the LUT and associates the I/O request with the physical 
device unit to which the entry points. The number of LUN assignments 
valid for a task ranges from 0 to 255, but it cannot be greater than 
the number of LUNs specified at task-build time. 


Figure 1-1 illustrates a typical Logical Unit Table. 


Pointer to UCB of LUN 1 
Pointer to window block of LUN 1 


Pointer to UCB of LUN 2 


Pointer to window block of LUN 2 


Pointer to UCB of LUN 3 


Pointer to window block of LUN 3 


Pointer to UCB of LUN 4 


Pointer to window block of LUN 4 


ZK-4078-85 


Figure 1-1 Logical Unit Table 


1.3.3 Changing LUN Assignment 


Logical unit numbers have no significance until you associate a LUN 
with a physical device unit by using one of the following methods: 


@e At the time you build the task that is to do the I/0 
operation, you can specify an ASG (Assign) keyword option to 
the Task Builder. This option associates a physical device 
unit with a logical unit number referenced by the task being 
built. 


@e You or the system operator can issue a DCL DEASSIGN command 
followed by a DCL ASSIGN/REDIRECT command. This command 
reassigns a LUN to another physical device unit and _ thus 
changes the correspondence between the LUN and the physical 
device unit. Note that this reassignment has no effect on the 
in-core image of a task. 


@e At run time, a task can dynamically change a LUN assignment by 
issuing the Assign LUN Executive macro (ALUNS$). This changes 
the association of a LUN with a physical device unit during 
task execution. 


1.4 ISSUING AN I/O REQUEST 


Your tasks perform I/O in the Micro/RSX system by submitting requests 


for I/0 service as Queue I/0 (QIOS) or Queue I/O And Wait (QIOWS) 
Executive macro. See the RSX-11M/M-PLUS and Micro/RSX Executive 
Reference Manual for a complete description of system macros. 
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The Micro/RSX operating system has a set of system macros that make 
issuing QIO$ macros easier. You must make these macros available to 
the source program by placing the MACRO-11 Assembler macro .MCALL in 
the source program. The macros reside in the System Macro Library 
(LB: [1,1]RSXMAC.SML). Section 1.6.4 describes the function of .MCALL. 


In Micro/RSX, as in most multiprogramming systems, tasks do not 
normally access physical device units directly. Instead, they use 1/0 
services that the Executive provides, because it can effectively 
multiplex the use of physical device units over many tasks. The 
Executive routes I/O requests to the appropriate device driver and 
queves them by the priority of the requesting task. I/O operations 
proceed concurrently with other activities in a Micro/RSX system. 


Before the Executive queues a QIOS request to the driver, the QIO$ 
must pass a series of tests executed by the Executive. If the request 
fails, the Executive rejects it. The Executive signals this rejection 
by setting the C-bit. As good programming practice, you should check 
for macro rejection by following the QIOS macro with a MACRO-11 BCS 
instruction. (In a high-level language, the status is returned ina 
single-word variable which is specified as part of the call.) 


After the Executive queues an I/O request, the system does not wait 
for the operation to complete. Perhaps the task that issued the QIOS 
request cannot proceed until the 1/0 operation completes. In this 
case, the task should specify an event flag (see Sections 1.4.3, 
1.5.2, and 1.6.2) in the QIO$ request and should issue a Wait For 
Single Event Flag (WTSES$) Executive macro specifying the same event 
flag at the point where synchronization must occur. Your task _ then 
waits for the I/O to complete by waiting for the Executive to set the 
specified event flag. 


The QIOS and Wait (QIOWS) macro is a more economical way to achieve 
this synchronization. QIOWS waits until the system completes the 1/0 
before returning control to the’ task. Thus, the additional WTSES 
macro is not necessary. 


Each QIO$ or QIOWS macro must supply sufficient information to 
identify and queue the I/0 request. You may also want to include 
locations in your task to receive error or status codes, and to 
specify the address of an asynchronous system trap service routine. 
Certain types of I/O operations require the specification of 
device-dependent information as well. Typical QIOS parameters are the 
following: 


e 1/0 function to be performed 


e Logical unit number associated with the physical device unit 
to be accessed 


e Optional event flag number for synchronizing I/O completion 
processing (required for QIOWS) 


@e Optional address of the I/O status block to which the 
Executive returns information indicating successful or 
unsuccessful completion 


@e Optional address of an asynchronous system trap service 
routine in your task to be entered upon completion of the I/0 
request 


@ Optional device- and function-dependent parameters specifying 
such items as the starting address of a data buffer, the size 
of the buffer, and a block number 
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Several of the first six parameters in the QIOS$ macro are optional, 
but you must reserve space for these parameters. During expansion of 
a QIOS macro, the Executive defaults to a value of 0 for all null 
(omitted) parameters. Inclusion of the device- and function-dependent 
parameters depends on the physical device unit and function that you 
specify. If you want to specify only an I/O function code, a LUN, and 
an address for an asynchronous system trap service routine, issue the 
following: 


QIOS IO.ATT,6,,,,ASTOX 
where: 
IO.ATT The I/O function code for attach. 
6 The LUN. 
KE Ve Null arguments for the event flag number, the request 


priority, and the address of the I/O status block. 


ASTOX The AST address. 


The system requires no additional device- or function-dependent 
parameters for an attach function. Section 1.6 describes the three 
legal forms of the macro. 


For convenience, you may omit any comma if no parameters appear to the 
right of it. Therefore, you could issue the command above as follows, 
if you did not want the asynchronous system trap: 


QIOS IO.ATT,6 


All extra commas have been dropped. However, if a parameter appears 
to the right of any place-holding comma, that comma must be retained. 


1.4.1 QIOS Macro Format 


The arguments for a specific QIO$ macro call may be different for each 
I/O device your task accesses and for each I/O function it requests. 
However, the general format of the call is common to all devices. It 
appears as follows: 


QIOsS fne,lun,[{efn],[pri],[isb],[ast],[{<pl,p2,...,p6>] 


1.4.1.1 Syntax Elements: Brackets [], Angle Brackets <>, Braces {} - 
The following describes the syntax elements used in this manual to 
describe the QIOS functions. 


{ ] Brackets enclose optional parameters. You may use one or 
more of the optional parameters. 


< Angle brackets must enclose function-dependent parameters if 
the QIOS requires the <pl,...,p6 parameters. The angle 
brackets are part of the syntax and must be used. The 


Parameters may or may not be present in a given QIOS macro 
and, if present, some may be optional. 


{} Braces indicate that you must make a choice among the 
arguments enclosed within the braces. 


The following paragraphs summarize the use of each QIOS parameter. 
Section 1.6 explains different forms of the QIO$ macro itself. 
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1.4.1.2 FNC Parameter - The fne parameter is the symbolic name of the 
I/O function that you want to request. This name is usually of the 
form 


IO.xxx 
where: 
xxx Identifies the particular I/O operation. 


For example, a QIO$ request to attach the physical device unit 
associated with a LUN specifies the function code IO.ATT with its 
complete QIOS form appearing as 


QIOS I0.ATT,1lun 
where: 
lun The number assigned to the physical device unit. 


A QIOS request to cancel (or kill) all I/O requests for a LUN that you 
specified begins like this: 


QIOS IO.KIL,... 


The system internally stores the fne parameter, which you specify in 
the QIO$ request, as a function code in the high-order byte and as 
modifier bits in the low-order byte of a single word. The function 
code is in the range 0 through 31. (decimal) and is a binary value 
that the system supplies to match the symbolic name specified in the 
QIOS request. 


The system object module library defines the correspondence between 
global symbolic names and function codes. The Task Builder searches 
the library. You can obtain local symbolic definitions by the FILIO$ 
and SPCIOS macros, which reside in the System Macro Library and are 
summarized in Appendix A. 


Several similar functions may have identical function codes, and _ you 
may distinguish them only by their modifier bits. For example, the 
DECtape read logical forward and read logical reverse functions have 
the same function code. Although the function codes are the same, the 
system stores the modifier bits for these two operations. 


1.4.1.3 LUN Parameter - The lun parameter represents the logical unit 
number (LUN) of the associated physical device unit that the I/0 
request is to access. The association between the physical device 
unit and the LUN is specific to the task that issues the I/O request, 
and the LUN reference is usually device independent. You begin an 
attach request to the physical device unit associated with LUN 14 like 
this: 


QIOS IO.ATT,14.,... 


Because each task has its own LUT in which the correspondence between 
the LUN and the physical device unit is established, the legality of a 
LUN parameter is specific to the task that includes this parameter in 
a QIOS request. In general, the LUN must be in the following range: 


0 <LUN <number of LUTs in table (if nonzero) /4 
;Each LUT is 2 words (4 bytes) 


The number of LUNs specified in the LUT of a particular task cannot 
exceed 255. 


MICRO/RSX INPUT/OUTPUT 


1.4.1.4 EFN Parameter - The efn parameter is a number representing 
the event flag to be associated with the I/O operation. It is an 
optional parameter for inclusion in the QIOS request. The specified 
event flag is cleared when the I/O request is queued and is set when 
the I/O operation has completed. If the task issued the QIOWS macro, 
the Executive suspends task execution until the I/O completes. If the 
task issued the QIOS macro (with no WTSES macro), task execution 
proceeds in parallel with the I/O. When the task continues to 
execute, it may test the event flag whenever it chooses by using the 
Read All Event Flags (RDAF$) macro (if group-global event flags are 
not being used), the Read Extended Flags (RDXF$) macro (for all event 
flags, including group-global event flags), or the Read Single Event 
Flag (RDEFS) macro. 


If you specify an event flag number, it must be in the range 1 through 
96. If you do not want to specify an event flag, you can omit efn or 
supply it with a value of 0. Event flags 1 through 32 are _ local 
(specific to the issuing task); event flags 33 through 64 are global 
(shared by all tasks in the system). Event flags 65 through 96 are 
group-global event flags (shared by all tasks in the same user group). 
Flags 25 through 32 and 57 through 64 are reserved for use by system 
software. Within these bounds, you can specify event flags as desired 
to synchronize I/O completion and task execution. Sections 1.4.2 and 
1.4.3 provide a more detailed explanation of significant events and 
event flags. 


NOTE 


If an event flag is not specified, the Executive 
treats the macro as if it were a simple QIOS request. 


1.4.1.5 PRI Parameter - The optional pri parameter is supplied only 
to make Micro/RSX QIOS requests compatible with RSX-11D. Thus, you 
should use a value of 0 (or a null) for this parameter. 


1.4.1.6 ISB Parameter - The optional isb parameter identifies the 
address of the I/O status block associated with the I/O request. This 
block is a 2-word array in which a code is returned that represents 
the final status of the I/0 request on completion of the operation. 
This code is a binary value corresponding to a symbolic name of the 
form IS.xxx (for successful returns) or IE.xxx (for error returns). 
The binary error code is returned to the low-order byte of the first 
word of the status block. It can be tested symbolically, by name. 
For example, the symbolic status IE.BAD is returned if a bad parameter 
is encountered. The following illustrates the examination of the I/0 
status block (IOSB, specified by IOST) to determine whether a bad 
parameter has been detected: 


QIOS IO.ATT,14.,2,,10ST 
BCS DIRERR 

WTSESC 2 

CMPB #IS.SUC,IOST 

BNE ERROR 
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The system object module library defines the correspondence between 
global symbolic names and I/0 completion codes. The Task Builder 
searches this library. The IOERRS$ macro, which resides in the System 
Macro Library, obtains local symbolic definitions summarized in 
Appendix B. 


On completion of the I/O operation, the system returns’ certain 
device-dependent information to the high-order byte of the first word 
of 1/0 status block. If a read or write operation is successful, the 
second word is also significant. For example, in the case of a read 
function on a terminal, the system returns in the second word of isb 
the number of bytes that you typed preceding a carriage return. If a 
magnetic tape unit is the device and you specified a write function, 
this number represents the number of bytes actually written. The 
status block can be omitted from a QIOS request if you do not intend 
to test for successful completion of the request. 


1.4.1.7 AST Parameter - The optional ast parameter specifies the 
address of a service routine to be entered when an asynchronous system 
trap occurs. If you want to interrupt your task to execute special 
code on completion of an I/O request, you can specify an asynchronous 
system trap routine in the QIOS$ request. When the specified I/0 
operation completes, control branches to this routine at the software 
priority of the requesting task. The system then executes’ the 
asynchronous code beginning at address ast, much like the way the 
system executes an interrupt service routine. If you do not want to 
perform asynchronous processing, you can omit the ast parameter or 
specify a value of 0 in the QIOS macro call. 


Sections 1.4.4 and 1.4.5 discuss asynchronous system traps, and_ the 
RSX-11M/M-PLUS and Micro/RSX Executive Reference Manual describes 
traps in detail. 


1.4.1.8 Pl,P2,...,P6 Parameters - The additional QIO$ parameters 
<pl,p2,...,p6 depend on the particular function and device specified 
in the I/O request. Typical parameters may include I/0 buffer 
address, I1/0 buffer length, and so on. You can include between zero 
and six parameters depending on the particular I/O function. 
Subsequent chapters of this manual describe rules for including these 
parameters and legal values. 


1.4.2 Significant Event 


A significant event is a change in system status that causes’ the 
Executive to reevaluate the eligibility of all active tasks to run. 
(For some significant events, specifically those in which the current 
task becomes ineligible to run, only those tasks of lower priority are 
examined.) A significant event is usually caused (either directly or 
indirectly) by an Executive directive issues as a macro from within a 
task. This manual is concerned with |the significant event caused by 
an I/O completion. 


Significant events are normally set directly or indirectly by 
Executive directives by completing a function that you specified. A 
task uses event flags to recognize the occurrence of specific events. 
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1.4.3 Event Flag 


Event flags are a means by which tasks recognize specific events. 
(Tasks also use Asynchronous System Traps (ASTs) to recognize specific 
events.) In requesting a system operation (such as an I/O transfer), a 
task may associate an event flag with the completion of the operation. 
When the event occurs, the Executive sets the specified flag. 


Ninety-six event flags are available to enable tasks to distinguish 
one event from another. Each event flag has a corresponding unique 
event flag number (efn). Numbers 1 through 32 form a group of flags 
that are unique to each task and are set or cleared as a result of 
that task's operation. Numbers 33 through 64 form a second group of 
flags that are common to all tasks, hence their name "common flags." 
Common flags may be set or cleared as a result of any task's 
operation. The last eight flags in each group, local flags (25-32) 
and common flags (57-64), are reserved for use by the system. Numbers 
65 through 96 form the third group of flags, known as "group global 
event flags." You can use these flags in any application where common 
event flags can be used; however, only tasks running under UICs 
containing the group code specified when the group-global event flags 
were created can use them. Eight Executive directives provide the 
support for creating, setting, clearing, reading, and testing event 
flags. See the RSX-11M/M-PLUS and Micro/RSX Executive Reference 
Manual for a description of these directives. 


The foliowing example illustrates the use of a common event flag to 
synchronize task execution. 


A task issues a QIOS macro with an efn parameter specified. A WTSES 
macro follows the QIOS and specifies the same event flag number as an 
argument. The Executive clears the event flag when the Executive 
queues the I/O request. Then, the Executive blocks the task when the 
Executive executes the WTSES directive. The task remains blocked 
until a significant event is declared at the completion of the I/0 
request and the significant event sets the event flag. The task 
resumes when the appropriate event flag is set, and execution resumes 
at the instruction following the WTSES macro. Using these macros’ and 
an event flag in this way ensures that the task does not manipulate 
the data until all the I/O has completed. 


Specifying an event flag does not mean that a WTSES macro must _ be 
issued. Event flag testing can be performed at any time. The purpose 
of a WTSES macro is to block the task execution until an indicated 
event occurs. Hence, it is not necessary to issue a WTSES macro 
immediately following a QIOS macro, but a task that depends on a 
specific I/O operation to complete must issue it before continuing. 


A task can issue a Stop For Single Event Flag (STSES) macro instead of 
a WTSES macro. When this is done, an event flag condition not 
satisfied results in the task's being stopped instead of being blocked 
until the event flag is set. A blocked task still competes for memory 
resources at its running priority. A stopped task competes for memory 
resources at priority 0. 


1.4.4 System Trap 


System traps can interrupt task execution and cause a transfer of 
control to another memory location for special processing. The 
Executive handles system traps. The traps are relevant only to. the 
task in which they occur. To use a system trap, a task must contain a 
trap service routine, which is automatically entered when the trap 
occurs. 
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There are two types of system traps: synchronous and asynchronous. 
You can use both to handle error or event conditions, but they differ 
in their relation to the task that is running when the traps are 
detected. The traps differ as follows: 


e Synchronous system traps (SSTs) signal error conditions within 
the executing task. If the same instruction sequence were 
repeated, the same synchronous trap would occur at the same 
place in the task. Synchronous traps are fully described in 
the RSX-11M/M-PLUS and Micro/RSX Executive Reference Manual. 

e Asynchronous system traps (ASTs) signal the completion of an 
external event such as an I/O operation. An asynchronous 
system trap (AST) usually occurs as the result of initiating 
or completing an external event rather than as a program 
condition. 


Although not able to distinguish execution of an SST routine from task 
execution, the Executive is aware that a task is executing an AST 
routine. An AST routine can be interrupted by an SST routine, but not 
by another AST routine. 


1.4.5 Asynchronous System Trap 


The primary purpose of an AST is to inform the task that a certain 
event has occurred -- for example, the completion of an I/O operation. 
As soon as the task has serviced the event, it can return to the 
interrupted code. 


Some macros can specify both an event flag and an AST; with these 
macros, you can use ASTs as an alternative to event flags or you can 
use the two together. Therefore, you can specify the same AST routine 
for several macros, each with a different event flag. Thus, when the 
Executive passes control to the AST routine, the event flag can 
determine the action required. However, it is standard programming 
practice to use the IOSB (specified by IOST) rather than the event 
flags to determine which I/0 operation is completed. Thus, when 
control is passed to an AST from a QIOS, the IOSB (specified by IOST) 
is on top of the stack. Use this IOSB to determine which I/0 has 
completed. 


The Executive queues ASTs in a first-in-first-out queue for each task 
and monitors all asynchronous’ service routine operations. Because 
asynchronous traps may be the end result of I/O-related activity, the 
task cannot control the occurrence of the ASTs directly. An example 
of an asynchronous trap condition is the completion of an I/O request. 
The timing of such an operation clearly cannot be predicted by the 
requesting task. If the task does not specify an AST service routine 
in an I/O request, a trap does not occur and normal task execution 
continues. 


However, the task may, under certain circumstances, block recognition 
of ASTs to prevent simultaneous access to a critical data region. 
When access to the critical data region has been completed, the queued 
ASTs may again be honored. The Disable AST Recognition (DSARSS) and 
Enable AST Recognition (ENARSS) macros provide the mechanism for doing 
this. 
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Associating asynchronous system traps with I/O requests enables’ the 
requesting task to be truly event driven. The system executes the AST 
service routine contained in the initiating task as soon as' possible, 
consistent with the task's priority. Using the AST routine to service 
I/O-related events provides a response time that is considerably 
better than a polling mechanism, and provides for better overlap 
processing than the simple QIOS and WTSES macros. Asynchronous system 
traps also provide an ideal mechanism for use in multiple buffering of 
I/O operations. 


The Executive inserts all ASTs in a first-in-first-out queue on a per 
task basis as they occur (that is, the event that they are to signal 
has expired). The Executive executes them one at a time whenever’ the 
task does not have ASTs disabled and is not already in the process of 
executing an AST service routine. Executing the AST includes’ storing 
certain information on the task's stack, including the task's WTSES 
mask word and address, the Directive Status Word (DSW), the program 
status (PS), the program counter (PC), and any trap-dependent 
parameters. The task's general-purpose registers RO-R5 are not saved, 
and thus AST service routines must save and restore all registers 
used. Jf the registers are not restored after an AST has_ occurred, 
the task's subsequent execution may be unpredictable. 


After an AST is processed, the trap-dependent parameters (if any) must 
be removed from the task's stack and an AST Service Exit ASTXS$S macro 
executed. The ASTXSS macro described in Section 1.6.7 of this manual 
issues the AST Service Exit macro. On AST service exit, control 
returns to another queued AST, to the executing task, or to another 
task waiting to run. 
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in detail the purpose of AST service routines and all Executive 
directives that handle them. 


1.5 DIRECTIVE PARAMETER BLOCK 


Directive Parameter Block (DPB) is a fixed-length area of contiguous 
memory that contains the arguments that you specify in a macro call. 
The DPB for a QIOS directive has a length of 12 words. The Executive 
generates it as the result of expanding a QIO$ macro call. The first 
two bytes of the DPB contain the following: 


e The first byte of the DPB contains the directive 
identification code (DIC) -- always 1 for QIOS. 


e The second byte contains the size of the DPB in 
words -- always 12 for Micro/RSX. 


During the assembly of your task containing QIO$ requests, the 
MACRO-11 Assembler generates a DPB for each I/O request specified in a 
QIOS macro call. At run time, the Executive uses the arguments stored 
in each DPB to create, for each request, an I/O packet in system 
dynamic storage. Figure 1-2 illustrates the layout of a sample DPB. 
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oO 


DIC for QiO 


—_—_ 


Word 0 size of DPB —> directive 


Modifiers 1/O function 


1 
2 


~<«—- Event flag number 


2 
a 
4 
~<«—- Logical unit number 
6 
3 Priority — 
8 


Address of I/O 
status block 
Address of 
asynchronous trap 
service routine 


4 


5 


Device-dependent 
parameters 


11 


ZK-005-81 
Figure 1-2 QIOS$ Directive Parameter Block 


1.5.1 I/0 Packet 


The Executive enters the I/O packet by priority into a queue of 1/0 
requests for the specified physical device unit. The Executive 
creates and maintains this queue and orders it by the priority of the 
tasks that issued the requests. The I/O drivers examine their 
respective I/O packet queues for the I1/0 request with the highest 
priority capable of being executed. The driver removes this packet 
from the queue and performs the I/O operation. The process is’ then 
repeated until the queue is empty of all requests. 


1.5.2 Significant Event Declaration 


After the I/O request has been completed, the Executive declares a 
Significant event and may do one or more of the following: 


e Set an event flag. 
e Cause a branch to an asynchronous system trap service routine. 
e Return the I/O status. 


Any of the above actions depend on the arguments specified in the 
original QIO$ macro. 


1.6 I/O RELATED MACRO 


The Micro/RSX system supplies several system macros to issue and 
return information about I/O requests. These macros reside in the 
System Macro Library and must be made available during assembly by 
including the MACRO-11 Assembler directive .MCALL in the task's code. 
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The Micro/RSX system also supplies FORTRAN-callable subroutines’ that 
perform the same functions as the system macros. See the 
RSX-11M/M-PLUS and Micro/RSX Executive Reference Manual for details. 
Most of the macros described in this section have three distinct 
forms. The following list summarizes the forms of QIOS, but the 
characteristics of each form also apply to QIOWS, ALUNS, GLUNS, and 
the other described macros. 


e QIOS (executed by using the DIRS macro) generates a directive 
parameter block for the I/O request at assembly time, but does 
not provide the instructions necessary to execute the request. 
The QIOS form is useful under the following conditions: 


- The task uses the DPB in several different places in the 
task. 


- The task modifies the DPB at run time. 
- The task references the DPB at run time. 


@e QIOSS generates a directive parameter block for the I/0 
request on the stack, and also generates code to execute the 
request. This is a useful form for reentrant, shareable code 
because QIOSS generates the DPB dynamically at execution time. 


@e QIOSC generates a directive parameter block for the I/0 
request at assembly time as well as generating code to execute 
the request. QIOSC generates the DPB in a separate program 
section called SDPBSS. QIOSC incurs little system overhead 
and it is useful when the task executes an I/0 request from 
only one location. This manual uses the C form of the QIOS 
macro in most of the examples in Chapter l. 


Parameters for both the QIOS and QIOSC forms of the macro must _ be 
valid expressions for the MACRO-11 .WORD and .BYTE statements. 
Parameters for the QIOSS form must be valid source operand address 
expressions for Assembler instructions such as MOV and MOVB. The 
following example references the same parameters in the three distinct 
forms of the macro call. 


QIOS IO.RLB,6,2,,,AST01,<RDBUF, 80. 
QIOSc IO.RLB, 6,2,,,AST01,<RDBUF, 80. 
QIOSs #IO.RLB, #6,#2,,,#ASTO1,<#RDBUF, #80. 


Only the QIOSS form of the macro produces the DPB dynamically. The 
other two forms generate the DPB at assembly time. The RSX-11M/M-PLUS 
and Micro/RSX Executive Reference Manual describes the characteristics 


— ee  _- 


The following section describes Executive directives issued as macros 
from within the task and Assembler directives: 


e QIO$, which requests an I/O operation and supplies parameters 
for that request 


@e QIOWS, which is equivalent to QIOS followed by WTSES 


e DIRS, which specifies the address of a directive parameter 
block as its argument, and generates code to execute the 
directive 


@e .MCALL, which makes all macros referenced during task assembly 
available from the System Macro Library 
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e ALUNS, which associates a logical unit number with a_ physical 
device unit at run time 

e GLUNS, which requests that the information about a physical 
device unit to LUN association be returned to a buffer that 
you specify 

e ASTXSS, which terminates execution of an asynchronous” system 
trap (AST) service routine 

e WTSES, which instructs the system to block execution of the 


1.6.1 


issuing task until a specified event flag is set 


The QIO$ Macro: Issuing an I/O Request 


As previously described, you may use three general forms of the QIO$ 


macro. They are reviewed as follows: 

@e QIOS$ generates only the DPB for the I/O request. This form of 
the macro call is used with DIRS (see Section 1.6.3) to 
execute an I/O request. 

@e QIOSS generates a DPB for the I/O request on the stack as well 
as generating code to execute the request. 

@ QIOSC generates a DPB and code, but the DPB is generated in a 


separate program section. 


1.6.2 The QIOWS Macro: Issuing an I/O Request and Waiting for an 


Event Flag 


The QIOWS macro is equivalent to a QIOS followed by a WTSES. It is 


more 


economical to issue a QIOWS request than to use the two separate 
macros. 


An event flag (efn parameter) must be specified with QIOWS. 


NOTE 


Please note that tasks or applications that execute 
many I/O operations will run much more efficiently 
using QIOWS rather than QIOS$ followed by a WTSES. The 
reason efficiency increases is that system overhead is 
reduced. 


The QIOWS macro has the following syntax: 


QIOWS function,lun,efn,([pri],[isb],{ast],[<pl,...,p6>] 


See the RSX-11M/M-PLUS and Micro/RSX Executive Reference Manual for 


1.6.3 The DIR$ Macro: Executing a Directive 


The DIRS (execute directive) macro allows a task to reference 
previously defined DPB. Issue it in the form: 


DIRS [addr], [err] 
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Parameters: 
The parameters have the following meanings: 
Parameter Meaning 


addr The address of a directive parameter block used in the 
directive. If addr is not included, the DPB itself or the 
address of the DPB is assumed to already be on the stack. 
This parameter must be a valid source operand for a MOV 
instruction generated by the DIRS macro. 


err An optional argument which specifies the address of an error 
routine to which control branches if the macro is rejected. 
The branch occurs by means of a JSR PC, err if the C-bit is 
set, indicating rejection of the QIOS macro. 


In the following example, the DIRS macro actually generates the code 
to execute the QIO$ directive. It provides no QIOS parameters of its 
own, but references the QIOS directive parameter block at address 
QIOREF by supplying this label as an argument. 


QIOREF: QIOS IO.RLB,6,2,,,AST01,<BUFFER, 80.> 

° ; CREATE QIOS DPB 
READ1: DIRS #QIOREF ; ISSUE I/O REQUEST 
READ2: DIRS #QIOREF ; ISSUE I/O REQUEST 


1.6.4 The .MCALL Directive: Retrieving System Macros 


-MCALL is a MACRO-11 Assembler directive that retrieves macros’ from 
the System Macro Library (LB:[1,1]RSXMAC.SML) for use during assembly. 
You must include it in every task that invokes system macros. ~MCALL 
is usually placed at the beginning of your task source module and 
specifies, as arguments in the call, all system macros that must be 
made available to your task from the library. 


The following example illustrates the use of this directive: 


-MCALL QIO$,QIOSS,DIRS,WTSESS ; MAKE MACROS AVAILABLE 


ATTACH: QIOSS #IO.ATT,#6,,, IOSB,#ASTO2 ; ATTACH DEVICE 


QIOREF: QIOS IO.RLB,6,,,I10SB,ASTO1l,... ; CREATE ONLY QIOS DPB 


READ]: DIR$ #QIOREF,DIRERR ISSUE I/O REQUEST 


=e 


You can include as many macro references as can fit on a line in a 
Single .MCALL directive. You can specify any number of .MCALL 
directives. 
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1.6.5 The ALUNS$ Macro: Assigning a LUN 


The Assign LUN macro associates a logical unit number with a physical 
device unit at run time. All three forms of the macro call may be 
used. Assign LUN does not request I/O for the physical device unit, 
nor does it attach the unit for exclusive use by the issuing task. It 
only establishes a LUN-physical device unit relationship, so that when 
the task requests I/O for that particular LUN, the task can reference 
the associated physical device unit. Issue the macro from a MACRO-11l 
program in the following way: 


ALUNS lun ,dev,unt 
Parameters: 
The parameters have the following meanings: 
Parameter Meaning 


lun The logical unit number to be associated with the specified 
physical device unit. See Sections 1.3 and 1.4.1.3. 


dev The device name of the physical device or a logical device 


name assigned to a physical device (see the DCL ASSIGN 
command). 


unt The unit number of that device specified above. 


For example, to associate LUN 10. with terminal unit 2, a task could 
issue the following macro call: 


ALUNSC 10.,TT,2 


A unit number of 0 represents unit 0 for multiunit devices such as 
disks, DECtape II, or terminals; it indicates the single available 
unit for devices without multiple units, such as card readers and line 
printers. 


See the RSX-11M/M-PLUS Command Language Manual or the Micro/RSX User's 
Guide for a full description of the ASSIGN command. 


The following example illustrates the use of the three forms of the 
ALUNS macro. 


DATA DEFINITIONS 


me Se NO 


ASSIGN: ALUNS 10.,TT,2 


GENERATE DPB 


me 


EXECUTABLE SECTION 


=e me Ne 


DIRS #ASSIGN 


EXECUTE DIRECTIVE 


=e 


ALUNSC 10.,TT,2 ; GENERATE DPB IN SEPARATE PROGRAM 
° ; SECTION, THEN GENERATE CODE TO 
; EXECUTE THE DIRECTIVE 


ALUNSS #10.,#"TT,#2 GENERATE DPB ON STACK, THEN 


; 
; EXECUTE DIRECTIVE 
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1.6.5.1 Physical Device Name - The following list contains physical 
device names, listed alphabetically, that you may include as dev 
parameters: 


Name Device 
DD TU58 DECtape II 
OL RLV12/RLO1/RLO2 Cartridge Disk 
OU RC25 Disk Subsystem, RQDX1/RD51 Fixed-Media Disk, RD52 


Fixed-Media Disk, RUX50 UNIBUS interface, and RX50 
Flexible Disk 


OY RXV21/RX02 Flexible Disk 

LP LPV11/LP25/LP26 Line Printers and LNO1/LNO3_ Laser 
Printer 

MS TSVO5 Magnetic Tape, TK25 Cartridge Tape 

MU TK50 Cartridge Tape 

NL The Null Device 

TT Terminals (regardless of interface) 

XE RSX QIO DEUNA Driver 

JA-JZ Reserved for customer use (not used by DIGITAL) 

QA-QZ Reserved for customer use (not used by DIGITAL) 

ZA-ZZ Reserved for customer use (not used by DIGITAL) 


1.6.5.2 Nonphysical Device Name - The following list contains names, 
listed alphabetically, that are not associated with a physical device 
but with a driver that interfaces with data structures instead of a 
real physical device (you may have heard these names referred to as 
pseudo devices but a pseudo device has a specific meaning in Micro/RSX 
- see Section 1.6.5.3): 


Name Device 
HT Network remote terminal 
NL The Null Device 
NS Network nonphysical device for NSP 
NX Network nonphysical device for DLX 
RD On-line reconfiguration pseudo-device 
RT Network Command Terminal 
VT Virtual terminal. Used by some offspring tasks as TI: 


for command and data I/0 
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1.6.5.3 Pseudo-Device Name - A pseudo-device name is a logical device 
name that must be directed to a physical device unit. A pseudo device 
name can be redirected, by the operator, to another physical device at 
any time without requiring changes in programs that reference the 
pseudo-device name. (The DV.PSE bit in the LUN information buffer is 
set to one if a pseudo device name is used to reference a physical 
device.) Dynamic redirection of a physical device unit affects all 
tasks in the system; reassignment by means of the DCL DEASSIGN command 
affects only one task. The following pseudo-devices are supported, as 
indicated: 


Code Device 

CL Console listing, normally the line printer. 

Co Console output, normally the main operator's console. 
LB System library device, normally the device from which 


the system was bootstrapped. For example, LB: is the 
device that tasks such as TKB and MAC access’ for 
default library files. 


SP Spooling scratch disk device. 


sy User default device. SY: is normally the default 
login device. 


Tr Pseudo-input terminal; TIO: is the terminal from which 
a task was requested. 


The pseudo-device TI cannot be redirected, since such 
redirection would have to be handled on a per-task 
rather than a system-wide basis (that is, change the TI 
device for one task without affecting the TI 
assignments for other tasks). 


1.6.6 The GLUNS$ Macro: Retrieving LUN Information 


The Get LUN Information macro requests the return of information about 
association between a LUN and physical device unit in a 6-word buffer 
specified by the issuing task. Upon successful completion of a QIOS 
macro, the buffer contains the information listed in Table 1-l, as 
appropriate for the specific device. All three forms of the macro 
call may be used. It is issued from a MACRO-11 program in the 
following way: 


GLUNS lun,buf 
Parameters: 
The parameters have the following meanings: 
Parameter Meaning 
lun The logical unit number associated with the physical device 
unit for which information is requested. See Sections 1.3 


and 1.4.1.3. 


buf The 6-word buffer to which information is returned. 
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For example, to request information on the disk unit associated with 
LUN 8, the following call is issued: 


GLUNSC 8., IOBUF 


Table l-1l 


Get LUN Information 


Numerical Offset 


Symbolic Offset 


Word Byte Bit Word Byte Bit 
0 G.LUNA 
1 0 G.LUNU 
1 G.LUFB 

2 G.Lucw 1 
0 (U.CW1) (DV. REC) 
4: (DV.CCL) 
2 (DV. TTY) 
3 (DV.DIR) 
4 (DV.SDI) 
5 (DV.SQD) 
6 (DV.MSD) 
7 (DV. UMD) 
8 (DV.EXT) 


1. The following word and bit symbols 
defining and referencing corresponding items in 


symbols used 
the device UCB. 


in 


Contents 


Name of device associated with 
LUN (ASCII bytes) 


Unit number of associated 
device 


Driver flag value. Returned as 
200 octal if the driver is 
resident, or as 0 if a loadable 
driver is not in the system 


First device characteristics 
word: 


Unit record-oriented device 
(for example, line printer) 
(1 = yes) 


Carriage-control device (for 
example, line printer, 
terminal) (1 = yes) 


Terminal device (1 = yes) 


Directory device (for example, 
disk) (1 = yes) 

Single directory device (for 
example, ANSI-standard magtape) 
(1 = yes) 


Sequential device (for example, 


ANSI-standard magtape) 
(1 = yes) 
Mass storage device (for 


example, disks and tapes) 
(1 = yes) 


User-mode diagnostics supported 
(1 = yes) 


22-bit direct addressing 
supported (1 = yes) 


shown in parentheses.) are 


(Continued on next page) 


Numerical Offset 
Word Byte Bit 


10 
ll 
12 


13 


14 


15 


2. For mass storage devices, 
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Table 1-1 (Cont.) 
Get LUN Information 


Symbolic Offset 


Word 


G.LUCW+02 


(U.CW2) 


G.LUCW+04 


(U.CW3) 


G.LUCW+06 


(U.CW4) 


Byte Bit 

(DV.SWL) 

(U2.xxx) 
(U3.xxx) 


Contents 


Unit software write-locked 
(1 = yes) 


(DV.ISP) Input spooled device 
(1 = yes) 


(DV.OSP) Output spooled device 
(1 = yes) 


(DV. PSE) Pseudo-device 
(1 = yes) 


(DV.COM) Device mountable as a 
communications channel for 
items in the device UCB 
(l = yes). 


(DV.Fll1l) Device mountable as a 
Files-l1l1 device (for example 
disk) (1 = yes) 


(DV.MNT) Device mountable 
(logical OR of bits 13 and 14) 
(1 = yes) 


Second device characteristics 
word: 


Device-specific information 


Third device characteristics 
word: 


Device-specific information 2 


Fourth device characteristics 
word: 


Default buffer size (for 
example, for disks, and line 
length for terminals). 


such as disks, and TU58 tape, this is 


the number of blocks (maximum logical block number plus one). For 
the proper use of the RXV21/RX02 flexible disk, it is important to 
be able to test G.LUCW+4 to determine the media density. 


The example following illustrates the use of the three forms of the 


GLUNS macro. 
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DATA DEFINITIONS 


=e sme MO 


GETLUN: GLUNS 6,DSKBUF 


GENERATE DPB 


=e 


EXECUTABLE SECTION 


=e ums NO 


DIRS #GETLUN ; EXECUTE DIRECTIVE 


GLUNSC 6,DSKBUF ; GENERATE DPB IN SEPARATE PROGRAM 
. ; SECTION, THEN GENERATE CODE TO 
; EXECUTE THE DIRECTIVE 


GLUNSS #6,#DSKBUF GENERATE DPB ON STACK, THEN 


; 
; EXECUTE DIRECTIVE 


1.6.7 The ASTX$S Macro: Terminating AST Service 


The ASTXSS macro terminates execution of an AST service routine. The 
Executive provides all forms of the macro. However, the S-form 
requires less space and executes at least as fast as the ASTXS$ or 
ASTXSC form of the macro. Issue it as follows: 


ASTXSS-_ [err] 
Parameters: 
The parameters have the following meanings: 
Parameter Meaning 


err An optional argument specifying the address of an error 
routine to which control branches if the macro is rejected. 


After the Executive completes the operation specified in this macro 
call, the Executive executes the next AST immediately if another AST 
is queued and asynchronous system traps have not been disabled. 
Otherwise, the Executive restores the task's state existing before the 
AST was entered. (The AST service routine must save and restore the 
registers it uses.) 


1.6.8 The WTSE$ Macro: Wait for Single Event Flag 


The WTSES macro suspends execution of the issuing task until the 
Executive sets the event flag specified in the macro call. This macro 
is extremely useful in synchronizing other activity with the 
completion of I/0 operations. You may use all three forms of the 
macro call. Issue it as follows: 


WTSES efn 
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Parameters: 

The parameters have the following meanings: 
Parameter Meaning 

efn The event flag number. 


WTSES blocks the task from execution until the specified event flag is 


set. Frequently, you may include an efn parameter in a QIO$ macro 
call, and the Executive sets the. event flag upon the completion of the 
I/O operation specified in that call. The following example 


illustrates task blocking until the specified event flag is set. This 
example also shows using three forms of the macro call. 


7 
-MCALL WTSES, ALUNSS, QIOSC, DIRS 
-MCALL QIOSS, WTSESS, WTSESC, 


DATA DEFINITIONS 


° 
’ 
e 
v 


WAIT: WTSES 5 
IOSB: - BLKW 2 


GENERATE DPB 
I/O STATUS BLOCK 


mo Ne 


EXECUTABLE SECTION 


=e se Se 


ASSIGN LUN 14 TO MAGNETIC 
TAPE UNIT ZERO 

ATTACH DEVICE 

EXECUTE WAIT FOR DIRECTIVE 


ALUNSS #14.,#"MM 


QIOSc IO.ATT,14.,5 
DIRS #WAIT 


me te MO MO 


QIOSS #IO.RLB, #14. ,#2,,#IOSB, ,<#BUF, #80. > 
. ; READ RECORD, USE EFN2 


WTSESS #2 ; WAIT FOR READ TO COMPLETE 


QIOScC IO.WLB,14.,3,,I10SB,,<BUF,80.> 


° ; WRITE RECORD, USE EFN3 
WTSESC 3 ; WAIT FOR WRITE TO COMPLETE 
QIOSc IO.DET,14. ; DETACH DEVICE 
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1.7 STANDARD I/O FUNCTION 


You can specify a large number of input/output operations with the 
QIOS macro. You can request a particular operation by including the 
appropriate function code as the first parameter of a QIOS macro call. 
Certain functions are standard. These functions are almost totally 
device independent and thus you can request them for nearly every 
device described in this manual. Other I/0 functions are device 
dependent and are specific to the operation of only one or two I/0 
devices. This section summarizes the function codes and 
characteristics of the following standard device-independent I/0 
operations: ; 


e Attaching to an I/0 device 

@e Detaching from an I/O device 
® Canceling I/0 requests 

@ Reading a logical block 

@e Reading a virtual block 

e Writing a logical block 

e Writing a virtual block 


For certain physical device units, a standard I/O function may be 
described as being a NOP. This means that no operation occurs as a 
result of specifying the function, and the Executive returns an I/O 
status code of IS.SUC in the I/O status block specified in the QIOS 
macro call. 


1.7.1 I/0 Subfunction Bit 


Most terminal QIOS functions can be modified by a Logical OR of the 
symbolic name of a subfunction bit with the QIOS function. The 
symbolic names of subfunction bits take the form TF.xxx, where xxx is 
the acronym of the subfunction to be performed. A standard QIOS 
function called IO.ATT (attach a device) that is specified in a 
Logical OR with the terminal-specific TF.ESQ subfunction (recognize 
escape sequences) would look like the following: 


CIOSC IO.ATT!TF.ESQ,lun, [efn], [pri], [isb], [ast] 


A subfunction bit modifies and extends the operation indicated by the 
terminal QIOS$ function. Often, you may want to use more than one 
subfunction bit. In this case, you may use several subfunction bits 
together in a Logical OR. AS an example, for the terminal driver, the 
standard QIOS IO.ATT function may be extended to both recognize escape 
sequences and allow special processing in the task upon the occurrence 
of asynchronous system traps. To do this requires that you OR_ two 
subfunction bits with the IO.ATT function. If you do this, the QIOS 
IO.ATT macro would look like the following: 


@IOSC IO.ATT!ITF.ESQ!TF.AST,1lun, [efn],[{pri],[isb], [ast] 


If your task invokes a subfunction bit that is not supported on the 
system, the subfunction bit may be ignored or an error may occur. 


The subfunction bits that apply to a specific QIOS macro are described 
with that QIOS macro in Chapter 2. 
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1.7.2 QIO$C IO.ATT - Attaching to an I/O Device 


Use the IO.ATT function code when your task requires exclusive use of 
an I/O device. The QIOSC IO.ATT macro can have the following format: 


QIOSC IO.ATT,1lun,[efn],[pri],[isb], [ast] 


Successful completion of an IO.ATT request exclusively dedicates the 
specified physical device unit to the task that issues the IO.ATT. 
This enables the task to process input or output in an unbroken stream 
and is especially useful on sequential, non-file-oriented devices such 
as terminals, card readers, and line printers. An attached physical 
device unit remains under control of the task until that task 
explicitly detaches it. To detach the device, the task issues’ the 
QIOScC IO.DET macro with the LUN previously assigned to the attached 
device. 


While a task attaches a physical device unit, the I/O driver for that 
unit dequeuves only I/O requests issued by the task that attaches the 
unit. However, a privileged task can issue a write breakthrough 
function (IO.WBT) to a terminal attached by another task. This is an 
exception for terminals only. Thus, except for the case of I0O.WBT, 
the Executive does not process a request to attach a device unit 
already attached by another task until the attachment by the first 
task is broken and no higher-priority request exists for the attached 
unit. 


A LUN that is associated with an attached physical device unit may not 
be reassigned by an Assign LUN (ALUNS$) macro unless at least one LUN 
is still assigned to the attached device. If the task that issued an 
attach function exits or is aborted before it issues a corresponding 
detach, the Executive detaches the physical device unit. 


Parameters: 
The parameters have the following meanings: 
Parameter Meaning 


lun The logical unit number of the associated physical device 
unit to be accessed by the I/0 request. For more 
information refer to Sections 1.3 and 1.4.1.3. 


efn The number of the event flag to be associated with the QIOS 
operation. For more information refer to Section 1.4.1.4. 


pri Makes Micro/RSX QIOS requests compatible with RSX-11D. A 
value of 0 (or a null) should be used for this parameter. 


isb The address of the I/O status block (I/O status double-word) 
associated with the I/O request. For more information refer 
to Section 1.4.1.6. 


ast For IO.ATT, specifies the address of a service routine to be 
entered when an asynchronous’ system trap occurs. If you 
want to interrupt your task to execute special code upon 
completion of this I/O request, you may specify ast. When 
this I/O request completes, control branches to the address 
specified by ast at the software priority of the requesting 
task. Omit ast or specify 0 to omit AST processing. For 
more information refer to Sections 1.4.4 and 1.4.5. 


See the RSX-11M/M-PLUS and Micro/RSX Executive Reference 
Manual for further details on ASTs. 
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1.7.3 QIOSC IO.DET - Detaching from an I/O Device 


IO.DET detaches a physical device unit that has been previously 


attached by an I0O.ATT request. Issue the QIOSC I0.DET macro as 
follows: 


QIOSC IO.DET,lun,[efn],[pri],[{isb], [ast] 
The LUN specifications of both IO.ATT and IO.DET must be the same, as 
in the following example, which also illustrates using S-forms of 


several macro calls. 


-MCALL ALUNSS,QIOSS 
ALUNSS #14.,#"LP ; ASSOCIATE LINE PRINTER WITH LUN 14 


QIOSS #IO. ATT, #14. ; ATTACH LINE PRINTER 


LOOP: QIOSS #IO.RLB,#14.,... ; PRINT 


QIOSS #IO.DET, #14. : DETACH LINE PRINTER 
Parameters: 


The parameters have the following meanings: 


Parameter Meaning 
lun The logical unit number of the associated physical device 
unit to be accessed by the I/0 request. For more 


information refer to Sections 1.3 and 1.4.1.3. 


efn The number of the event flag to be associated with the QIO$ 
operation. For more information refer to Section 1.4.1.4. 


pri Makes Micro/RSX QIOS requests compatible with RSX-11D. A 
value of 0 (or a null) should be used for this parameter. 


isb The address of the I/O status block (I/O status double-word) 
associated with the I/O request. For more information refer 
to Section 1.4.1.6. 


ast Specifies the address of a service routine to be entered 
when an asynchronous system trap occurs. If you want to 
interrupt your task to execute special code upon completion 
of this I/0 request, you may specify ast. When this I/0 
request completes, control branches to the address specified 
by ast at the software priority of the requesting task. 
Omit ast or specify 0 to omit AST processing. For more 
information refer to Sections 1.4.4 and 1.4.5. 


1.7.4 QIO$C I0.KIL - Canceling I/O Requests 


IO.KIL cancels the issuing task's I/0 requests for a particular 
physical device unit. 
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For I/O requests waiting for service (that is, in the I/0 driver's 
queue) the Executive returns a status code of IE.ABO in the I/O status 
block. An event flag is set, if specified. But any AST service 
routine that you may have specified is not executed. 


For I/O requests being processed by any I/O driver, except the disk 
drivers, the Executive returns the IE.ABO status code. The Executive 
also returns other status information (byte count, and so on) in the 
I/O status block. An AST, if specified, is executed. 


For disk or TU58 tape I/O requests being processed when an I0.KIL is 
issued, the IO.KIL acts as a NOP. The request is allowed to complete. 
Because a disk operates quickly, IO.KIL causes the return of IS.SUC in 
the I/O status block. 


IO.KIL is useful in such special cases as canceling an I/O request on 
a physical device unit from which a response is overdue. 


The QIOSC IO.KIL macro has the following format: 
QIosc IO.KIL,lun,[{efn],[{pri],[isb], [ast] 

Parameters: 

The parameters have the following meanings: 

Parameter Meaning 


lun The logical unit number of the associated physical device 
unit to be accessed by the I/0 request. For more 
information refer to Sections 1.3 and 1.4.1.3. 


efn The number of the event flag to be associated with the QIOS 
operation. For more information refer to Section 1.4.1.4. 


pri Makes Micro/RSX QIOS requests compatible with RSX-11D. A 
value of O (or a null) should be used for this parameter. 


isb The address of the I/O status block (I/O status double-word) 
associated with the I/O request. For more information refer 
to Section 1.4.1.6. 


ast Specifies the address of a service routine to be entered 
when an asynchronous’ system trap occurs. If you want to 
interrupt your task to execute special code upon completion 
of this I/0 request, you may specify ast. When this I/0 
request completes, control branches to the address specified 
by ast at the software priority of the requesting task. 
Omit ast or specify 0 to omit AST processing. For more 
information refer to Sections 1.4.4 and 1.4.5. 


1.7.5 QIO$C I0.RLB - Reading a Logical Block 


Issue IO.RLB to read a block of data from the specified physical 
device unit. The QIOSC IO.RLB macro has the following format: 


QIosc IO.RLB,lun,| efn | ,<stadd,size,pn> 


,| pri 
,| isb 
,| ast 
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Parameters: 


The parameters have the following meanings: 


Parameter Meaning 
lun The logical unit number of the associated physical device 
unit to be accessed by the I/O request. For more 


information refer to Sections 1.3 and 1.4.1.3. 


efn The number of the event flag to be associated with the QIOS 
operation. For more information refer to Section 1.4.1.4. 


pri Makes Micro/RSX QIOS$ requests compatible with RSX-11D. A 
value of 0 (or a null) should be used for this parameter. 


isb The address of the I/O status block (I/O status double-word) 
associated with the I/O request. For more information refer 
to Section 1.4.1.6. 


ast Specifies the address of a service routine to be entered 
when an asynchronous’ system trap occurs. If you want to 
interrupt your task to execute special code upon completion 
of this I/0 request, you may specify ast. When this I/0 
request completes, control branches to the address specified 
by ast at the software priority of the requesting task. 
Omit ast or specify 0 to omit AST processing. For more 
information refer to Sections 1.4.4 and 1.4.5. 


stadd The starting address of the data buffer. The address must 
be word aligned for certain drivers; stadd may be on a byte 
boundary. 

size The size of the stadd buffer in bytes. The buffer must be 


within the task's address space. 


pn One to four optional parameters that specify such additional 
information as block numbers for certain devices. 


1.7.6 QIO$C I0.RVB ~— Reading a Virtual Block 


IO.RVB reads a virtual block of data from the specified physical 
device unit. A "virtual" block indicates a relative block position 
within a file and is identical to a logical block for such sequential, 
record-oriented devices as terminals and card readers. For these 
sequential, record-oriented devices, the Executive converts IO.RVB_ to 
IO.RLB before it issues them. 


NOTE 


Any subfunction bits specified in the I0O.RVB_ request 
are stripped off in this conversion. 


All tasks should use virtual rather than logical reads unless the task 
must issue subfunctions. However, if a task issues a virtual read for 
a file-structured device (disk or DECtape II), you must ensure that a 
file is open on the specified physical device unit. Issue IO.RVB as 
follows: 


QIOSC IO.RVB,lun,| efn |,<stadd,size,pn> 


,| pri 
,| isb 
rj} ast 


Parameters 


The parame 
Parameter 


lun 


efn 


pri 


isb 


ast 


stadd 


size 


pn 


1.7.7 QIO 


IO.WLB wri 
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ters have the following meanings: 
Meaning 


The logical unit number of the associated physical device 
unit to be accessed by the I/0 request. For more 
information refer to Sections 1.3 and 1.4.1.3. 


The number of the event flag to be associated with the QIOS 
operation. For more information refer to Section 1.4.1.4. 


Makes Micro/RSX QIOS requests compatible with RSX-11D. A 
value of 0 (or a null) should be used for this parameter. 


The address of the I/O status block (I/O status double-word) 
associated with the I/O request. For more information refer 
to Section 1.4.1.6. 


Specifies the address of a service routine to be entered 
when an asynchronous’ system trap occurs. If you want to 
interrupt your task to execute special code upon completion 
of this I/O request, you may specify ast. When this I/0 
request completes, control branches to the address specified 
by ast at the software priority of the requesting task. 
Omit ast or specify 0 to omit AST processing. For more 
information refer to Sections 1.4.4 and 1.4.5. 


The starting address of the data buffer. The address must 
be word aligned for certain drivers; stadd may be on a byte 
boundary. 


The size of the stadd buffer in bytes. The buffer must be 
within the task's address space. 


One to four optional parameters that specify such additional 
information as block numbers for certain devices. 


$C IO.WLB - Writing a Logical Block 


tes a block of data to the specified physical device unit. 


If an IO.WVB write function is issued to a terminal, the Executive 


converts a 
Note that 
example, 
converted 
The QIOSC 


QIosc 


n IO.WVB to an IO.WLB request. 

any subfunction bits specified in the IO.WVB reuest (for 
TF.CCO, TF.WAL, or TF.WBT) are stripped when the IO.WVB is 
to an IO.WLB. 

IO.WLB macro has the following format: 


IO.WLB,lun,| efn | ,<stadd,size,pn 


,| pri 
,| isb 
r7)/ ast 
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Parameters: 


The parameters have the following meanings: 


Parameter Meaning 
lun The logical unit number of the associated physical device 
unit to be accessed by the I/O request. For more 


information refer to Sections 1.3 and 1.4.1.3. 


efn The number of the event flag to be associated with the QIOS 
operation. For more information refer to Section 1.4.1.4. 


pri Makes Micro/RSX QIO$ requests compatible with RSX-11D. A 
value of 0 (or a null) should be used for this parameter. 


isb The address of the I/O status block (I/0 status double-word) 
associated with the I/O request. For more information refer 
to Section 1.4.1.6. 


ast Specifies the address of a service routine to be entered 
when an asynchronous system trap occurs. If you want to 
interrupt your task to execute special code upon completion 
of this I/0 request, you may specify ast. When this I/0 
request completes, control branches to the address specified 
by ast at the software priority of the requesting task. 
Omit ast or specify 0 to omit AST processing. For more 
information refer to Sections 1.4.4 and 1.4.5. 


stadd The starting address of the data buffer. The address must 
be word aligned for certain drivers; stadd may be on a byte 
boundary. 

size The size of the stadd buffer in bytes. The buffer must be 


within the task's address space. 


pn One to four optional parameters that specify such additional 
information as block numbers or format control characters 
for certain devices. 


1.7.8 QIOSC IO.WVB - Writing a Virtual Block 


IO.WVB writes a virtual block of data to a physical device unit. A 
virtual block indicates a block position relative to the start of a 
file. For sequential, record-oriented devices such aS terminals and 
line printers, the Executive converts IO.WVB to IO.WLB. 


NOTE 


Any subfunction bits specified in the IO.WVB- request 
(see Sections 2.3.1 and 3.3.1) are stripped off in 
this conversion. 


All tasks should use IO.WVB rather than IO.WLB to file-structured 
devices. However, if you issue a virtual write for a file-structured 
device (disk or DECtape II), you must ensure that a file is open on 
the specified physical device unit. For record-oriented devices, you 
should use IO.WLB. 
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Note that any subfunction bits specified in the IO.WVB request (for 
example, TF.CCO, TF.WAL, or TE.WBT) are stripped when the IO.WVB is 
converted to an IO.WLB. 

The QIOSC IO.WVB macro has the following format: 


QIOSC IO.WVB,lun,| efn | ,<stadd,size,pn> 


,| pri 
,| isb 
,| ast 


Parameters: 


The parameters have the following meanings: 


Parameter Meaning 
lun The logical unit number of the associated physical device 
unit to be accessed by the I/0 request. For more 


information refer to Sections 1.3 and 1.4.1.3. 


efn The number of the event flag to be associated with the QIO$ 
operation. For more information refer to Section 1.4.1.4. 


pri Makes Micro/RSX QIOS requests compatible with RSX-11D. A 
value of O (or a null) should be used for this parameter. 


isb The address of the I/O status block (I/O status double-word) 
associated with the I/O request. For more information refer 
to Section 1.4.1.6. 


ast Specifies the address of a service routine to be entered 
when an asynchronous’ system trap occurs. If you want to 
interrupt your task to execute special code upon completion 
of this I/0 request, you may specify ast. When this I/0 
request completes, control branches to the address specified 
by ast at the software priority of the requesting task. 
Omit ast or specify 0 to omit AST processing. For more 
information refer to Sections 1.4.4 and 1.4.5. 


stadd The starting address of the data buffer. The address must 
be word aligned for certain drivers; stadd may be on a byte 
boundary. 

size The size of the stadd buffer in bytes. The buffer must be 


within the task's address space. 


pn One to four optional parameters, specifies such additional 
information as block numbers or format control characters 
for certain devices. 


1.8 USER-MODE DIAGNOSTIC FUNCTIONS 


The I/O function code subfunction bit, IQ.UMD, provides support for 
user-mode diagnostics. To perform a diagnostic function, you must 
specify in the QIO$ directive parameter block the logical OR of IQ.UMD 
and the function you want to perform. For example, to perform a 
diagnostic Read Logical Block operation, specify QIOSC IO.RLB!1IQ.UMD 
as the I/O function code parameter to the QIOS macro. You can execute 
Standard I/O functions such as Read Logical Block, Write Logical 
Block, Attach to Device, and Detach from Device in diagnostic mode. 
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Support for user-mode diagnostics is always present for Micro/RSX, but 
not all drivers support user-mode diagnostic functions. Unpredictable 
device and driver behavior results when you set the IQ.UMD subfunction 
bit in QIOSs that are directed to the device if it does not support 
user-mode diagnostics. You can avoid problems if you issue a Get LUN 
(GLUNS) macro and check the user-mode diagnostics bit before emitting 
the user-mode diagnostic QIOS. 


To support user-mode diagnostics, the DV.UMD bit in the UCB must be 
set. DV.UMD is at offset U.CWl in the UCB. 


In addition to standard I/0 functions, Micro/RSX provides the 
following device-dependent, user-mode diagnostic functions: 


1. TU58 cartridge tape diagnostic functions 
e I0.BLS Block seek (explicit seek) 
2. Magtape diagnostic functions 
e I0.LPC Read longitudinal parity character 
e I0O.ERS Erase tape 
UMDIOS is the macro that defines these functions. 
To execute a user-mode diagnostic function, you must first attach the 
device for diagnostics using I/O function code IO.ATT!IQ.UMD. Execute 


the diagnostic functions and then detach. 


The parameter list in words 1 through 6 of the DPB should contain’ the 
following information: 


e 1/0 buffer address 
e 1/0 buffer size 
e Double-precision logical block number 


e User's register buffer address (the I/O driver copies its 
hardware registers to this buffer in the user's program); see 
a hardware reference manual for the length of the address 


A typical DPB for a diagnostic function might look like the following: 


SDSKPB:: ; 

Size of the DPB, QIOWAIT 
directive code 

I/O function code 

Logical unit number 

Event flag number 

I/O status block address 


-BYTE 3,12. 


-WORD IO.WDH!IQ.UMD 
-WORD THELUN 

-BYTE  THEEFN,0 
-WORD SIOSTS 


.»WORD 0 AST address 
SIOBUF:: .WORD 0 Buffer address 

.»WORD 0 Transfer size in bytes 

-WORD 0 Device dependent 
SLBH: : -WORD 0 High-order logical block number 
SLBL: : »WORD 0 Low-order logical block number 


me Me MO TO NO TO We WH We WH NTO We WE 


- WORD SRGBUF Register buffer address 

The user-mode diagnostic functions return either Success (IS.SUC) or 
Device Not Ready (IE.DNR). No other error codes are returned. All 
error recovery is completely up to the user. Any errors that occur 
will not be logged in the error log. 
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A typical program fragment, using the user-mode diagnostic functions, 
might look like the following: 


-MCALL UMDIOS,ALUNSS ,QIOSS 


UMDIOS ; Define diagnostic functions 
ALUNSS #14.,#"DL, #0 ; Associate DLO with LUN 14 


QIOSssS #IO.ATT!IQ.UMD, #14. ; Attach DL for diagnostic I/0 


QIoss #IO.WLB! I1Q.UMD, #14.,,,,,<#SIOBUF,#512.,,#LBH, #LBL, #SRGBUF> 
; Write logical block 


QIoss #IO.WCK!IQ.UMD,#14.,,,,,<#SIOBUF, #512.,,#LBH, #LBL, #SRGBUF> 
; Write check 


QIOSS #I10.DET!IQ.UMD, #14. ; Detach DL 


1.9 1/0 COMPLETION 


When the system completes an I/O request, either successfully or 
unsuccessfully, the Executive selects return conditions depending upon 
the parameters included in the QIOS macro call. There are three major 
returns: 


e The Executive declares a significant event when an I/O 


operation completes execution. If you included ane efn 
parameter in the I/O request, the corresponding event flag is 
set. 


@ If you included an isb parameter in the QIO$ macro call, the 
Executive returns a code identifying the type of success or 
failure. The code is in the low-order byte of the first word 
of the I/O status block at the location represented by isb. 


This status return code is of the form IS.xxx (success) or 
IE.xxx (error). For example, if the device accessed by the 
I/O request is not ready, a status code of IE.DNR is’ returned 
in isb. The section named Return Codes summarizes gereral 
codes returned by most of the drivers described in this 
manual. 


If the isb parameter was omitted, the requesting task cannot 
determine whether the I/O request was successfully completed. 
A carry clear return from the macro itself simply means’ that 
the macro was accepted and the I/O request was queued, not 
that the actual input/output operation was successfully 
performed. 


@ If you specified an ast parameter in the QIO$ macro call, a 
branch to the AST service routine beginning at the location 
identified by ast occurs when the I/O operation completes 
execution. See Sections 1.4.5 and 1.6.7 for a description of 
AST service routines. 
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1.9.1 Return Codes 


The Executive recognizes and handles two kinds of status conditions 
when they occur in I/O requests: 


e Directive conditions, which indicate the acceptance or 
rejection of the QIOS$ macro itself 


e I/0 status conditions, which indicate the success or failure 
of the I/O operation 


Directive conditions relevant to I/O operations may indicate any of 
the following: 


e Directive acceptance 

e Invalid buffer specification 

e Invalid efn parameter 

e Invalid lun parameter 

@e Invalid DIC number or DPB size 
e Unassigned LUN 

e Insufficient memory 


The Executive returns a code indicating the acceptance or rejection of 
a directive to the Directive Status Word at symbolic location SDSW. 
You can test this location to determine the type of directive 
condition. 


I/O conditions indicate the success or failure of the I/0 operation 
that you specified in the QIO$ macro. I/0 driver errors include such 
conditions as device not ready, privilege violation, file already 
open, or write-locked device. If you include an isb parameter in the 
QIOS macro, identifying the address of a two-word I/O status' block, 
the Executive returns an I/O status code in the low-order byte of the 
first word of this block when an I/O operation completes execution. 
This code is a binary value corresponding to a symbolic name of the 
form IS.xxx or IE.xxx. You can test the low-order byte of the word 
symbolically, by name, to determine the type of status return. The 
system object module library defines the correspondence between global 
symbolic names and directive and I/O completion status codes. You may 
also obtain local symbolic definitions by the DRERRS and _ IOERRS 
macros, which reside in the System Macro Library and are summarized in 
Appendix B. 


Binary values of status codes always have the following meanings: 


Code Meaning 
Positive (greater than 0) Successful completion 
0 Operation still pending 
Negative Unsuccessful completion 


A pending operation means that the I/O request is still in the queue 
of requests for the respective driver, or the driver has not yet 
completely serviced the request. 
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1.9.2 QIOS Macro Conditions 


Table 1-2 summarizes the macro conditions that your task may encounter 
by issuing QIOS$ macros. The table lists acceptance condition first, 
followed by error codes indicating various reasons for rejection. 


Table 1-2 
Macro Conditions 


Code Reason 
IS.SUC Directive accepted 


The first six parameters of the QIOS$ macro were 
valid, and sufficient dynamic memory was available 
to allocate an I/O packet. 


IE.ADP Invalid address 


The I/O status block or the QIOS DPB was outside of 
the issuing task's address space or was not aligned 
on a word boundary. 


IE. IEF Invalid event flag number 


The efn specification in a QIOS macro was less than 
0 or greater than 96. 


IE.ILU Invalid logical unit number 


The lun specification in a QIO$ macro was_ invalid 
for the issuing task. For example, there were only 
5 logical unit numbers associated with the task, 
and the value specified for lun was greater than 5. 


IE.SDP Invalid DIC number or DPB size 


The directive identification code (DIC) or the size 
of the Directive Parameter Block (DPB) was 
incorrect; the legal range for a DIC is from 1 
through 127, and all DIC values must be odd. Each 
individual directive requires a DPB of a certain 
size. If the size is not correct for the 
particular directive, this code is returned. The 
size of the QIOS$ DPB is always 12 words. 


IE.ULN Unassigned LUN 


The logical unit number in the QIOS macro was not 
associated with a physical device unit. Your task 
may recover from this error by issuing a_ valid 
Assign LUN (ALUNS) macro and then reissuing the 
rejected macro. 


IE.UPN Insufficient dynamic memory 


There was not enough dynamic memory to allocate an 
I/O packet for the I/O request. You can try again 
later by blocking the task with a 
Wait-For-Significant Event (WTSES) macro. Note 
that WTSES is the only effective way for the 
issuing task to block its execution, because other 
macros for this purpose require dynamic memory for 
their execution (for example, Mark Time (MRKTS)). 
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1.9.3 I/0 Status Conditions 
The ccntents of the 2-word I/O status block is explained next: 


e The low-order byte of the first word receives a status code of 
the form IS.xxx or IE.xxx when an I/O operation completes 
execution. 


e The high-order byte of the first word is usually device 
dependent 


e The second word contains the number of bytes transferred or 
processed if the operation is successful and involves reading 
or writing. 


If the isb parameter of the QIOS macro is omitted, this information is 
not returned. 


The fcllowing illustrates an example 2-word I/O status block on 
completion of a terminal read operation: 


1 0 Byte 


-10 


Number of bytes read 


where -10 is the status code for IE.EOF (end of file). If this code 
is returned, it indicates that input was terminated by typing CTRL/Z, 
which is the end-of-file termination sequence on a terminal. 


To test for a particular error condition, your task generally should 
compare the low-order byte of the first word of the I/O status block 
with a symbolic value, as in the following: 


CMPB #IE.DNR,IOSB 


However, to test for certain types of successful completion of the I/0 
operation, the entire word value must be compared. For example, if a 
carriage return terminated a line of input from the terminal, a 
successful completion code of IS.CR is returned in the I/O status 
block. If an Escape (or Altmode) character was the terminator, a code 
of IS.ESC is’ returned. To check for these codes, your task should 
first test the low-order byte of the first word of the block for 
Is.SUC and then test the full word for IS.CC, IS.CR, IS.ESC, or 
IS.ESQ. (Other success codes that must be read in this manner are 
listed in Appendix B, Section B.1.2.) 


Note that both of the following comparisons test as equal because’ the 
low-order byte in both cases is +l. 


CMP #1S.CR,IOSB 

CMPB #IS.SUC, IOSB 
In the case of a successful completion where the carriage return is 
the terminal indicator (IS.CR), the following illustrates the status 
block: 


1 0 Byte 


l Number of bytes read 
(excluding the CR) 
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where 15 is the octal code for carriage return and +1 is the status 
code for successful completion. 


Table 1-3 summarizes status codes that may be returned in the 1/0 
status block specified in the QIO$ macro on completion of the I/0 
request. The codes described in Table 1-3 are general status’ codes 
that apply to the majority of devices presented in subsequent 
chapters. Error codes specific to only one or two drivers are 
described only in relation to the devices for which they are returned. 
Table 1-3 describes successful and pending codes first, then error 
codes. 


Table 1-3 
I/O Status Conditions 


Code Reason 


IS.SUC Successful completion 


The I/0 operation specified in the QIO$ macro was 
completed successfully. The second word of the I/0 
status block can be examined to determine the 
number of bytes processed, if the operation 
involved reading or writing. 


IS.PND I/O request pending 


The I/O operation specified in the QIO$ macro has 
not yet been executed. The I/O status block is 
filled with Os. 


IE.ABO Operation aborted 


The specified I/O operation was canceled with 
IO.KIL while in progress or while still in the 1/0 
queue. 


IE.ALN File already open 


The task attempted to open a file on the physical 
device unit associated with the specified LUN, but. 
a file has already been opened by the issuing’ task 
on that LUN. 


IE.BAD Bad parameter 


An invalid specification was supplied for one or 
more of the device-dependent QIOS parameters (words 
6 - 11). For example, a bad channel number or gain 
code was specified in an analog-to-digital 
converter I/O operation. 


IE.BBE Bad block on device 
The disk sector (block) being read was marked as a 


bad block in the header’ word. Data cannot be 
written on or read from bad blocks. 


(Continued on next page) 
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Table 1-3 (Cont.) 
I/O Status Conditions 


Code Reason 


IE.BLK Illegal block number 


An invalid block number was’ specified for a 
file-structured physical device unit. 


IE.BYT Byte-aligned buffer specified 


Byte alignment was specified for a buffer, but only 
word (or double-word) alignment is legal for the 
physical device unit. For example, a disk function 
requiring word alignment was requested, but the 
buffer was aligned on a byte boundary. 
Alternatively, the length of a buffer was not an 
appropriate multiple of bytes. 


IE.DAA Device already attached 


The physical device unit specified in an _ I0O.ATT 
function was already attached to the issuing task. 
This code indicates that the issuing task has 
already attached the desired physical device unit, 
not that the unit was attached by another task. 


IE.DNA Device not attached 


The physical device unit specified in an _ I10.DET 
function was not attached to the issuing task. 
This code has no bearing on the attachment status 
of other tasks. 


IE.DNR Device not ready 


The physical device unit specified in the QIOS 
macro waS not ready to perform the desired I/0 
operation. This code is often returned as_ the 
result of an interrupt time-out; that is, a 
reasonable amount of time has passed, and the 
physical device unit has not responded. 


IE. EOF End-of-file encountered 


An end-of-file mark, record, or control character 
was recognized on the input device. 


IE.FHE Fatal hardware error 
Controller is physically unable to reach the 


location where input/output is to be performed on 
the device. The operation cannot be completed. 


(Continued on next page) 


MICRO/RSX INPUT/OUTPUT 


Table 1-3 (Cont.) 
I/O Status Conditions 


Code | Reason 


IE. IFC Illegal function 


A function code that was invalid for the specified 
physical device unit was specified in an I/0 
request. This code is returned if the task 
attempts to execute an invalid function or if, for 
example, a read function is requested on an 
output-only device, such as the line printer. 


IE.NLN File not open 


The task tried to close a file on the physical 
device unit associated with the specified LUN, but 
no file was currently open on that LUN. 


IE.NOD Insufficient buffer space 


Dynamic storage space has been depleted, and not 
enough buffer space was available to allocate a 
secondary control block. For example, if a task 
attempts to open a file, buffer space for the 
window and file control block must be supplied by 
the Executive. This code is returned when there is 
not enough space for such an operation. 


IE.OFL Device off line 


The physical device unit associated with the LUN 
specified in the QIOS$ macro was not on line. When 
the system was. bootstrapped, a device check 
indicated that this physical device unit was not in 
the configuration. 


IE.OVR Illegal read overlay request 
A read overlay was requested and the physical 
device unit specified in the QIOS$ macro was not the 
physical device unit from which the task was 
installed. The read overlay function can be 
executed only on the physical device unit from 
which the task image containing the overlays was 
installed. 

IE.PRI Privilege violation 


The task that issued a request was not privileged 
to execute that request. 


IE.SPC Illegal address space 
The following conditions can cause this error: 
e The buffer that your task requested for a_ read 
or write operation was partially or totally 


outside the address space of your task. 


e You specified a byte count of 0. 


(Continued on next page) 
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Table 1-3 (Cont.) 
I/O Status Conditions 


Code: Reason 


e You specified TF.XCC and AST2 in the same QIOS 
request. 


IE.VER Unrecoverable error 
After the system attempted its standard number of 
retries after an error occurred, the operation 
still could not be completed. This code is 
returned in the case of parity, CRC, or similar 
errors. 

IE.WCK Write check error 


An error was detected during the check (read) 
following a write operation. 


IE.WLK Write-locked device 


The task attempted to write on ae write-locked 
physical device unit. 


1.10 POWER-FAIL RECOVERY PROCEDURES FOR DISKS AND DECTAPE 


Power-fail recovery recommendations for various devices are included 
in the following chapters. For disks, power recovery ASTs should be 
used. Prior to returning for normal I/O operations, the AST service 
routine should provide a sufficient time delay for the disk to attain 
normal operating speed before actually attempting read and write 
operations. 


If QIOSs are being used for disk I/O operations during power-fail 
recovery, an IE.DNR error status may be returned if the device is not 
up to operating speed when the request is issued. When this error is 


returned, your task should wait for the device to attain operating 
speed and attempt the I/O operation again prior to reporting an error. 


1.11 MICRO/RSX DEVICES 
The devices listed below are supported by Micro/RSX. Drivers are 
supplied for each of these devices, and I/O operations for them are 
described in detail in subsequent chapters of this manual. 
1. A variety of terminals, including the following: 

e LA12 DECwriter 

e LA100 DECwriter 

e LA120 DECwriter III 

e LQPO2 Letter-Quality Printer 


e LA50O Personal Printer 
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VT100 Alphanumeric Display Termina 
VT101 Alphanumeric Display Termina 
VT102 Alphanumeric Display Termina 
VT1O5 Alphanumeric Display Termina 
VT125 Alphanumeric Display Termina 
VT131 Alphanumeric Display Termina 


VT132 Alphanumeric Display Termina 


1 


1 


1 


1 


1 


1 


1 


vVT200 Series Alphanumeric Display Terminal 


These terminals are supported on the 
line interfaces: 


DHV11 Asynchronous Communications 
Multiplexer 


DZQ11 Asynchronous Communications 
Multiplexer 


DLV11 Asynchronous Communications 
Multiplexer 


DZV11l Asynchronous Communications 
Multiplexer 


The following disks: 


RLV12/RLO1 or RLO2 Cartridge Disk 


RQDX1/RQDX2 Controllers 


following asynchronous 


Line 


Line 


Line 


Line 


Interface 


Interface 


Interface 


Interface 


RD51 Fixed-Media Disk and RX50 Flexible Disk 


RD52 Fixed-Media Disk 
RXV21/RX02 Flexible Disk 
KDA50 Controller 
RQC25/RC25 Disk System 


RA60, RA80, and RA81 Disks 


The following magnetic tapes: 


CPU Serial Line /TU58 DECtape II 
TSV0O5/TK25 Magnetic Tape Subsystem 


TQK50/TK50 Magnetic Tape Subsystem 
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The following line printers: 


e LPV1l Controller with LP25 or LP26 Line Printers 


e LNO1/LNO3 Laser Printers 


The "Null Device," a software 
eliminating unwanted output 


Virtual Terminals 
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construct 


that 


facilitates 
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FULL-DUPLEX TERMINAL DRIVER 


2.1 INTRODUCTION 
This chapter describes the full-duplex terminal driver (TTDRV.TSK) 
supplied with the Micro/RSX System. It describes the QIOSs that you 
can use to read from or write to the terminal in full-duplex mode. It 
also describes the subfunction bits that you can combine in a Logical 
OR with the QIOS$ functions which modify and enhance the QIOS 
functions. 
The Micro/RSX full-duplex terminal driver has the following features: 

e Full-duplex operation 

e Type-ahead buffering 

e Eight-bit characters 

e Detection of hard receive errors 

e Large byte transfer length (8128 bytes) 

@ Settable terminal characteristics 

e Settable terminal types 

e Optional time-out on solicited input 

@e Device-independent cursor control 


e Redisplay of prompt buffer upon CTRL/R or CTRL/U 


e Automatic XOFF character generation upon completion of a_ read 
(except when in the full-duplex mode), if requested 


e Autobaud speed detection 


2.1.1 The Full-Duplex Terminal Driver and Supported Devices 


The full duplex terminal driver supports the following terminal 
devices: 


@e LA12 Portable Terminal 
e LA100 DECprinter 
e &LA120 DECwriter 


® LQP0O2 Letter-Quality Printer 
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e LA50 Personal Printer 
e VT100 DECscope 

e VT101 DECscope 

e VT102 DECscope 

e vT105 DECscope 

e VvT200 Series 


Terminal input lines can have a maximum length of 8128 (8K minus 64) 
bytes. Extra characters of an input line that exceed the maximum line 
length generally become an unsolicited input line if the terminal is 
not attached. 


The terminal devices listed above are connected to your microcomputer 
through asynchronous serial line interfaces. The Micro/PDP-11 is 
delivered with two DLVll-like asynchronous’ single line interfaces, 
giving the capability for connecting two terminal devices, one of 
which is the console terminal. In addition to these two interfaces, 
there are asynchronous multiplexers that you can use for connecting 
multiple terminals to the Micro/RSX System: the DZQ11-CP multiplexer, 
the DZV1ll multiplexer and additional DLV11 multiplexers or the DHV11 
multiplexer. The DZQ11-CP Asynchronous Serial Line Multiplexer 
interfaces up to four asynchronous serial lines to the Q-Bus providing 
the capability of connecting four terminal devices to the system. It 
Supports programmable baud rates. However, transmit and receive baud 
rates nust be the same. The DHV1l interfaces eight asynchronous 
lines, providing the capability for connecting eight terminal devices; 
this multiplexer is for the full-duplex terminal driver only. 


For additional information about the terminal devices and _ line 
interfaces see the MICRO/PDP-11 Handbook and the Terminals’ and 
Communications Handbook. 


2.2 GET LUN INFORMATION MACRO 


Word 2 of the buffer filled by the Get LUN Information system 
directive (the first characteristics word) contains the following 
information for terminals. A setting of 1 indicates that the 
descrived characteristic is true for terminals. 


Bit Setting Meaning 
a) 1 Record-oriented device 
L 1 Carriage-control device 
2 1 Terminal device 
3 0 File structured device 
4 0 Single-directory device 
5 0 Sequential device 
6 0 Mass storage device 
7 0 User-mode diagnostics supported 
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Bit Setting Meaning 
8 0 Device supports 22-bit direct addressing 
9 0 Unit software write-locked 
10 0 Input spooled device 
11 0 Output spooled device 
12 0 Pseudo device 
13 0 Device mountable as a communications 
channel 
14 0 Device mountable as a FILES-11 volume 
15 0 Device mountable 


Words 3 and 4 of the buffer are undefined. Word 5 indicates’' the 


default buffer size (the width of the terminal carriage or display 
screen). 


2.3 QIO$ MACRO 
Standard QIO$ functions are general in use and may be used with any 


device, while device-specific QIOS$ functions apply to specific devices 
or uses only. 


2.3.1 Format of QIO$C for Standard Functions 
The QIO$ macros for standard functions take the following forms: 


I0.DET 


QIosc IO.ATT) ,.26, 
IO.KIL 


QIosc aed peee,<Stadd,size,, [tmo]> 
IO.RVB 


QIOSC IO.WLB) ,...,<stadd,size,vfc> 
‘16 wee, 


2.3.2 Format of QIOSC for Device-Specific Functions 

The QIO$ macro for device specific functions take the following forms: 
QIOSC IO.ATA,...,<ast, [parameter2],[ast2]> 
QIO$C 10.CCO,...,<stadd,size,vfc> 
QIOSC IO.EIO,...,<stadd,size> 


QIosc ees pees <Stadd,size> 
10.GTS 
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QIOSC IO.HNG,..., 


QrIosc oe ,oe,<Stadd,size, [tmo] > 
I0O.RNE 

QIOSC IO.RPR,...,<stadd,size,[tmo] ,pradd,prsize,vfe> 

QIOSC IO.RST,...,<stadd,size, [{tmo]> 

QLOSsc TORRID owsotateddvsiee cf emely abies 

QIOSsc SF.SMC,...,<stadd,size> 


QIOsc ees peee,<Stadd,size,vfc> 
IO.WBT 


Table 2-1 lists the standard and device-specific functions of the QIOS 
macro that are valid for terminals. The standard functions are 


described in Chapter 1. Two device-specific functions, SF.SMC_ and 
SF.GMC, have nonstandard function names. 


Table 2-1 
Standard and Device-Specific QIOS$ Functions for Terminals 


Format Function 


STANDARD FUNCTIONS: 


READ FUNCTIONS 


QIOSC IO.RLB,...,<stadd,size, [tmo] > READ logical block 
(read typed input into 
buffer). 

QIOSC IO.RVB,...,<Stadd,size, [tmo] > READ virtual block 
(read typed input into 
buffer). 


WRITE FUNCTIONS 


QIOSC IO.WLB,...,<stadd,size,vfc> WRITE logical block 
(print buffer 
contents). 


QIOSC IO.WVB,...,<stadd,size,vfc> WRITE virtual block 
(print buffer 
contents). 


ATTACH, DETACH, AND CANCEL FUNCTIONS 


a 


QIOSC IO.ATT,... Attach device. 
OLOSE -LO.DET p65 % Detach device. 
QIOSC IO.KIL,... Cancel I/O requests. 
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Table 2-1 
Standard QIOS Functions for Terminals 


Format 


DEVICE-SPECIFIC FUNCTIONS: 


READ FUNCTIONS 


QIOSC 


QIose 


Qrose 


QIosc 


QIoOSsc 


WRITE 


QIOSC 


Qr1ose 


IO.RAL,...,<stadd,size,[tmo]> 


IO.RNE,...,<Stadd,size, [tmo] > 


IO.RPR,...,<Stadd,size, [tmo] 
,pradd,prsize,vfc> 


IO.RST,...,<stadd,size,[tmo] > 


IO.RTT,...,<stadd,size, [tmo] 
,table> 


FUNCTIONS 


IO.WAL,...,<stadd,size,vfe> 


IO.WBT,...,<stadd,size,vfc> 


MISCELLANEOUS FUNCTIONS 


QIOSc 


QIOSc 


QIOSC 


QIosc 


Qr1osc 


QIose 


QIos¢e 


IO.ATA,...,<asSt, [parameter2] 


,Last2]> 


IO0.CCO,...,<stadd,size,vfc> 


IO.EIO ees peee,<stadd,size> 


ITF .WLB 


SF.GMC,...,<stadd,size> 


SF.SMC,...,<stadd,size> 


I10.GTS,...,<stadd,size> 


IO.HNG,... 


Function 


READ logical block, 
pass all characters. 


READ logical block, do 
not echo. 


READ logical block 
after prompt. 


READ logical block 
ended by special 
terminators. 


READ logical block 
ended by specified 
special terminators. 


WRITE logical block, 
pass all characters. 


WRITE logical block, 
break through any I/0 
conditions at 
terminal. 


ATTACH device, specify 
unsolicited-input- 
character AST. 


CANCEL CTRL/O (if in 
effect), then write 
logical block. 


Extended I/O 


GET multiple 
characteristics. 


SET multiple 
characteristics. 


GET terminal support. 


HANGUP remote line. 
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2.3.3 Parameters 


The parameters for the various QIO$ macros have the _ following 


meanings: 
Parameter 
ast 


parameter2 


ast2 


pradd 


prsize 


stadd 


size 


table 


tmo 


vfc 


Meaning 
The entry point for an unsolicited input-character AST. 


A number that you can specify in your task to identify 
this terminal device as the input source upon entry to an 
unsolicited character AST routine. 


The entry point for a CTRL/C AST. 


The starting address of the byte buffer where the prompt 
is stored. 


The size of the pradd prompt buffer in bytes. The 
specified size must be greater than 0 and less than or 
equal to 8128 bytes. The buffer must be within the task's 
address space. 


The starting address of the data buffer. The address must 
be word aligned for IO.EIO, SEF.GMC, I0.GTS, and SF.SMC; 
otherwise, stadd may be on a byte boundary. 


The size of the stadd data buffer in bytes. The specified 
size must be greater than 0 and less than or equal to 8128 
bytes. The buffer must be within the task's address 
space. For IO.EIO, SFE.GMC, I0.GTS, and SF.SMC functions, 
size must be an even value. 


The address of the 16-word user-defined terminator table. 


An optional time-out count specified in 10-second 
intervals. (For IO.EIO, the interval is specified in 
seconds.) Time-out is the maximum time allowed between two 
input characters before the read is aborted. The maximum 
time-out value is 255(decimal) intervals. 


If 0 is specified, the read times out immediately after 
reading any data that may be in the type-ahead buffer. In 
other words, if you enter a 0, no time is allowed for you 
to enter characters, and all characters are read from the 
type-ahead buffer. 


If you need more than 255 (decimal) intervals (or 
255(decimal) seconds for IO.EIO), issue an asynchronous 
QIOS request followed by a Mark Time directive (MRKTS$) for 
the required interval. Specify different event flags in 
the two directives and, after issuing them, wait for the 
Logical OR of the two event flags. 


The terminal driver responds to task I/O requests’ for 
cursor positioning without the task requiring information 
about the type of terminal in use. 


The vfc parameter specifies cursor position. The 
parameter is interpreted as a vfc parameter if the high 
byte of the parameter is 0. However, if the parameter 
defines cursor position, the high byte must be nonzero, 
the low byte is interpreted as column number 
(x-coordinate), and the high byte is interpreted as line 
number (y-coordinate). 
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Parameter Meaning 


Home position, the upper left corner of the display, is 
defined as l,l. The driver outputs cursor-positioning 
commands appropriate for the terminal in use that move the 
cursor to the specified position. If the most significant 
bit of the line number is set, the driver clears’ the 
display before positioning the cursor. 


Table 2-9 is a summary of all characters that your’ task 
can use for vertical format control on the terminal. Any 
one of these characters can be specified as the value of 
the vfc parameter. 


2.3.4 Subfunction Bits 


Most of the device-specific functions supported by terminal drivers 
described in this section are selected by using subfunction bits. One 
Or more functions can be achieved by the Logical OR of the subfunction 
with the function, as IO.RPR!ITF.RNE (read logical block after prompt 
with no echo). Specifying the function and subfunction in this way 
combines as an OR their relative bits in a QIOS function. Table 2-2 
contains a listing of QIOS functions and relative subfunction bits 
that can be issued. 


Each subfunction bit and subfunction selected when it is included in a 
QIO$ function is listed with its symbolic name and meaning as follows: 


Subfunction Meaning 


TF .AST Unsolicited-Input-—Character AST - For IO.ATT or 
IO.ATT!ITF.ESC, ast specifies the address of an AST 
service routine to be entered when an unsolicited input 
character is entered. Control passes to ast whenever 
an unsolicited character (other than CTRL/Q, CTRL/S, 
CTRL/X, or CTRL/O) is entered at the terminal. 


TF.BIN Binary Prompt (Send Prompt As Pass All) - The prompt is 
sent to the terminal without interpretation by the 
driver. This is similar, for the prompt, to a 
write-pass-all. 


TF .CCO Cancel CTRL/O - Allows writing a logical block of data 
to the terminal regardless of a CTRL/O condition that 
may be in effect. If CTRL/O is in effect, it is 
canceled before the write occurs. 


TF.ESQ Recognize Escape Sequences - Escape sequences from. the 
terminal are returned to the task. Otherwise, ESC is a 
line terminator. This subfunction is for use with 
IO.ATA or IO.ATT. 


TF .NOT Notification Of Unsolicited Input - Unsolicited input 
causes an AST and entry into the AST service routine in 
the task. When the terminal driver receives 
unsolicited terminal input (except CTRL/C) and you used 
the TF.NOT subfunction with IO.ATA, the resulting AST 
serves only as notification of unsolicited terminal 
input; the terminal driver does not pass the character 
to the task. Upon entry to the AST service routine, 
the high byte of the first word on the stack identifies 
the terminal causing the AST (parameter2 in the IO.ATA 
function). 


Subfunction 


TF.RAL 


TF.RCU 


TF.RDI 


TF.RES 


TF.RLB 


TF.RLU 


TF.RNE 


TF .RNF 
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Meaning 


Using the TF.NOT subfunction allows a task to monitor 
more than one terminal for unsolicited input without 
the need to continuously read each terminal for 
possible unsolicited input. Note that the TF.NOT 
subfunction cannot be used with the CTRL/C AST (ast2 in 
IO.ATA); an unsolicited CTRL/C character flushes the 
type-ahead buffer. 


Read All Characters (Pass All) - Allows the passage of 
all characters to the requesting task. The driver does 
not intercept control characters. The characteristic 
TC.8BC, when set, allows the driver to pass 8 bits. 
For example, CTRL/C, CTRL/Q, CTRL/S, CTRL/O, and CTRL/Z 
are passed to the task and not interpreted by the 
driver. 


Restore Cursor Position - When defining cursor position 
in a function, you can use the TF.RCU subfunction to 
save the current cursor position. When included in 
this manner, TF.RCU causes the driver to first save the 
current cursor position, then position the cursor and 
output the specified buffer, and, finally, restore the 
cursor to the original (saved) position once the output 
transfer has been completed. 


Read With Default Input - The default input that you 
specified in the extended I/O item list is displayed as 
an input line at the start of the read on the terminal. 
You may change this line or use it as input to the 
system. This subfunction is for the extended I/0 
function (IO.EIO) only. 


Read With Escape Sequence Processing Enabled - This 
subfunction enables escape sequence recognition for the 
read operation in extended I/0; it is effective for 
only one read. 


Read Logical Block - This subfunction causes the driver 
to read a logical block from the specified terminal; it 
is for use with the extended I/0 (IO.EIO) function 
only. : 


Read With Lowercase to Uppercase Conversion - The’ task 
that uses this subfunction gets input in the buffer in 
upper case; it is for use with the extended I/0 
(IO.EIO) function only. 


Read With No Echo - Reads terminal input characters 
without echoing the characters back to the terminal for 
immediate display. You can use this feature when 
typing sensitive information. CTRL/R is ignored while 
Read With No Echo is in progress. 


Read With No Filter - Read and pass through CTRL/U, 
CTRL/R, and DELETE characters as normal characters. 
This subfunction is for use with the extended I/0 
(IO.EIO) function only. 


Subfunction 


TE.RPR 


TF.RPT 


TF.RST 
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Meaning 


Read After Prompt (For Extended I/O (IO.EIO) only) - 
The TF.RPR subfunction causes a prompt to be sent to 
the terminal and immediately follows it with a= read 
function at the terminal. The TF.RPR functions as an 
IO.WLB (to write a prompt to the terminal) followed by 
IO.RLB. However, TF.RPR differs from the combination 
of those two functions as follows: 


e System overhead is lower with the TEF.RPR because 
only one QIOS is processed. 


e When using the TEF.RPR function, there is no "window" 
during which a response to the prompt may be 
ignored. Such a window occurs if the task uses 
IO.WLB followed by an IO.RLB, because no read may be 
posted at the time the response is received. 


e If the issuing task is checkpointable, it can be 
checkpointed during both the prompt and the read 
requested by the TF.RPR. 


e A CTRL/O that may be in effect prior to issuing the 
TE.RPR is canceled before the prompt is written. 


NOTE 


If an TF.RPR function is in progress when the 
driver receives a CTRL/R or CTRL/U, the prompt 
is redisplayed. 


Read In Pass-Through Mode - Passes all characters 
except XON/XOFF. Allows the passage of all characters 
to the requesting task. The characteristic TC.8BC, 
when set, allows the driver to pass eight bits instead 
of 7. The driver intercepts the control characters 
CTRL/S and CTRL/Q. Other control characters, for 
example, CTRL/C, CTRL/O, and CTRL/Z are passed to the 
task and not interpreted by the driver. This 
subfunction is for use with the extended I/0 (I0O.EIO) 
function only. 


Read With Special Terminators - Special characters 
terminate the read. These characters are in the ranges 
0-037 and 175-177. The driver does not interpret the 
terminating character. For example, a DELETE or RUBOUT 
(177) does not erase, and a CTRL/C does not produce a 
CLI prompt, or, if CTRL/C abort is enabled, abort tasks 
active at the terminal. Also CTRL/U and CTRL/R do not 
perform their usual functions. All control characters 
are terminators. 


TF.RST sets TF.TNE by default, which means that 
terminators are not echoed on the terminal screen. 


If uppercase to lowercase conversion is disabled, 
characters 175 and 176 do not act as terminators. 
CTRL/O, CTRL/Q, and CTRL/S (017, 021, and 023, 
respectively) are not special terminators. The driver 
interprets them as output control characters in a 
normal manner. 


Subfunction 


TF.RTT 


TF.TMO 


TF.TNE 


TF WAL 


TF .WBT 
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Meaning 


Read With The Terminator Table That You Specify - Use 
this subfunction with the IO.EIO extended I/O function 
only. Control characters function normally with this 
subfunction. Terminators echo by default. The 
additional use of subfunction TF.TNE prevents’ the 
echoing of terminators on the terminal screen. If you 
want to use special control characters as terminators, 
their normal function should be disabled with the 
subfunctions TF.RNF or TF.RAL, or the characteristic 
TC.PTH. The terminator table (a bit mask table) length 
can be from 1 through 32(decimal) bytes where bit 0 is 
a null character, bit 1 is a CTRL/A, and so forth. The 
terminator table address is in the item list of the 
IO.EIO function. To use ASCII characters 128 through 
255(decimal), the characteristic TC.8BC must be set. 


Read With Time-Out - This subfunction allows the use of 
the tmo parameter to require input from the terminal 
within a specified time. 


Specify the time-out count in 10-second intervals. 
(For I0O.EIO, the interval is specified in seconds.) 
Time-out is the maximum time allowed between two input 
characters before the read is aborted. The maximum 
time-out value is 255(decimal) intervals. 


If 0 is specified, the read times out immediately after 
reading any data that may be in the type-ahead buffer. 
In other words, if you enter a 0, no time is_ allowed 
for you to enter characters, and all characters are 
read from the type-ahead buffer. 


If you need more than 255(decimal) intervals (or 
255(decimal) seconds for IO.EIO), issue an asynchronous 
QIO$ request followed by a Mark Time directive (MRKTS) 
for the required interval. Specify different event 


flags in the two directives and, after issuing them, 
wait for the Logical OR of the two event flags. 


Read Terminators With No Echo - Allows reading 
terminator characters from the terminal without their 
being echoed on the terminal screen as they are 
entered. Use this subfunction with the extended I/0 
function IO.EIO. 


Write All Characters - During a write-pass-all 
operation (as in IO.WAL or IO.WLB!TF.WAL), the terminal 
driver outputs characters without interpretation. It 


does not intercept control characters and it does not 
keep track of cursor position. Long lines are not 
wrapped around if input/output wrap around has been 
selected. 


Break-through Write - This subfunction instructs the 
driver to write the buffer regardless of the I/O status 
of the receiving terminal. If another write function 
is currently in progress, it finishes’ the current 
request and the break-through write is the next write 
issued. Therefore, the TF.WBT subfunction cannot break 


Subfunction 


TF.WIR 


TF .WLB 


TE .XCC 


TF .XOF 
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Meaning 


through another break-through write that is in 
progress. The effect of this is that a CTRL/S can stop 
break-through write functions. Thus, it may be 
desirable for tasks to time out on break-through 
operations. 


If a read is currently posted, the break-through write 
proceeds, and an automatic CTRL/R is performed to 
redisplay any input that was received before the 
break-through write was effected (if the terminal is 
not in the full-duplex mode). 


CTRL/O, if in effect, is canceled. 
An escape sequence that was interrupted is rubbed out. 


Break-through write may be issued by a privileged task 
only. (The privileged MCR command BRO (broadcast) uses 
IO.WBT.) 


Write With Input Redisplayed - This subfunction 
performs a write to the terminal. If a read is in 
progress at the terminal and you have entered 
characters in the input line, the prompt and the 
characters are redisplayed at the end of the write. 


Write Logical Block To The Specified Device 
Unit - Write logical block to the specified terminal. 
This subfunction is used with the extended I/O (I0O.EIO) 
function only. 


Exclude CTRL/C or Abort Active Task -Use the TF.XCC 
subfunction with the IO.ATA function. When TF.XCC is 
included in the IO.ATA function, all characters (except 
CTRL/C) are handled in the manner previously described. 
CTRL/C marks the beginning of a command line 
interpreter (CLI) line that is processed by a CLI task, 
or, if CTRL/C abort is enabled, aborts tasks active at 
the terminal. None of the characters, including the 
CTRL/C, are sent to the task issuing the function. 


Note that you can use either ast2 or TF.XCC, but not 
both in the same QIO request. If both are specified in 
the request, an IE.SPC error is returned. 


Send XOFF - The driver sends an XOFF to the terminal 
after its read. The XOFF (CTRL/S) may have the effect 
of inhibiting input from the terminal, if the terminal 
recognizes XOFF for this purpose. TF.XOF is ignored 
when full-duplex I/O is in use. 


Table 2-2 lists subfunction bits that can be executed in a Logical OR 
with QIO functions. 


The following example is a QIO request using more than one subfunction 
bit: a nonechoed read (TEF.RNE), terminated by a special terminator 
character (TF.RST), and preceded by a prompt. 


QIOSC IO. RPR!ITF.RNE!ITF.RST,...,<stadd,size,,pradd,prsize,vfc> 
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2.4 


The following sections describe the device-~specific functions for 


full-duplex terminal driver. 


2.4.1 


Any given function except SF.GMC, SF.SMC, IO.EIO, and 
OR of a particular subfunction bit with 


issued by using a Logical 
another QIO function. Table 2-2 lists 
allowed subfunctions. The subfunction 


DEVICE-SPECIFIC QIO FUNCTIONS 


Functions and Allowed Subfunctions 


I0.GTS 


the 


can be 


the functions with their 
bits are specified in the 
described 


following QIOSC function descriptions; subfunction bits are 


in general in Section 2.3. 


Equivalent 
Function 


STANDARD FUNCTIONS 


IO.ATT 
IO0.DET 
IO. KIL 
10.RLB 
10.RvBt 
IO.WLB 
10.wvBl 


4. 


Table 2-2 
Subfunction Bits - Summary 


Allowed 
Subfunctions Subfunctions 


TF.AST, 


TF.RAL, 
TF.RAL, 
TF.CCO, 
TF.CCO, 


DEVICE-SPECIFIC FUNCTIONS 


10.ATA IO.ATT!ITF.AST 
IO0.CCO IO.WLB! TF.CCO 
I0.EI02 

SF.GMC 

10.GTS 

IO. RAL IO0.RLB! TF.RAL 
IO. RNE I0.RLB!TF.RNE 
IO.RPR 

IO.RST IO.RLB!TF.RST 
IO.RTT 

SF.SMC 

IO.WAL IO.WLB! TF.WAL 
IO.WBT 10.WLB!TF.WBT 


TF.ESQ, 
TF .WAL, 
TF.RLB, 


TF.RNE, 
TF.RAL, 
TF.BIN, 
TF.XOF 

TF.RAL, 
TF.RAL, 


TF.CCO, 
TF.CCO, 


TF.ESQ 


TE.RNE, 


TF.RNE, 


TF .RCU, 


TF.RCU, 


TF.NOT, 
TF .WBT 
TF .WLB 


TF.RST, 
TF.RST, 
TF.RAL, 


TF.RNE, 
TF.RCU, 


TF.RCU, 
TF.RCU, 


TF.RST, 
TF.RST, 
TE .WBT, 
TF.WAL, 


TF.XCC 


TF.TMO, 
TF.TMO, 
TE.RNE, 


TF.TMO, 
TF.RNE, 


TF .WBT 
TF .WAL 


TF.TMO, TE.XOF 
TF.XOF 


TF.TMO, 
TF .WAL 
TF.WBT 


TF. XOF 
TF.XOF 


TF.RST, TF.TMO, 


TF. XOF 
TF.TMO 


1. Subfunctions are stripped off if they are specified with 


IO.RVB or IO.WVB. 


2. TF.RLB or TE.WLB but not both must be used with IO.EIO. 


In addition to the 


device-specific 


QIO$ 


functions, 
sections also describe the use of subfunction bits. 


the 


following 
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2.4.2 QIOSC IO.ATA - Attach a Terminal with ASTs 


The QIOS$ IO.ATA macro attaches the terminal and identifies ast and 
ast2 as entry points for unsolicited input-character ASTs_ that 
processes these characters. With ast and ast2, I0.ATA’ specifies 
asynchronous system traps (ASTs) to process unsolicited input 
characters (other than CTRL/Q, CTRL/S, CTRL/X, or CTRL/O). A minimum 
of one AST parameter (ast or ast2) is required. 


IO.ATA is equivalent to the IO.ATT attach function in a Logical OR 
with the subfunction bit TF.AST. 


The use of IO.ATA is enhanced by the addition of TF.NOT and TF.XCC 
subfunction bits, described later in this section. You may include 
any or all of the subfunctions described in this section with the 
IO.ATA function. 


Unless the TF.XCC subfunction is specified, CTRL/C is trapped by the 
task and does not reach the Command Line Interpreter. Thus, any task 
that uses IO.ATA without the TF.XCC subfunction should recognize some 
input sequence as a request to terminate; otherwise, the Command Line 
Interpreter cannot be invoked to abort the task in case of difficulty. 


The format of the QIOSC IO.ATA macro is as follows: 
QIOSC IO.ATA}] !TF.ESQ | ,lun,| efn | ,<{ast],[parameter2],[ast2]> 
{TF .NOT ,| pri 
ITF. XCC 7 | isb 


Parameters: 


The parameters have the following meanings: 


Parameter Meaning 
lun The logical unit number of the associated physical device 
unit to be accessed by the I/0 request. For more 


information refer to Chapter l. 


efn The number of the event flag to be associated with the 
QIOS operation. For more information refer to Chapter l. 


pri Makes this QIOS macro compatible with RSX-11D. Use a 
value of 0 or a null for this parameter. 


isb The address of the I/O status block (1/0 status 
double-word) associated with the I/O request. For more 
information refer to Chapter l. 


ast The entry point for an unsolicited input-character AST. 
Either ast or ast2 is required. 


Control passes to ast whenever an unsolicited character 
(other than CTRL/Q, CTRL/S, CTRL/X, or CTRL/O) is entered 
at the terminal. If ast2 is not specified, an unsolicited 


CTRL/C results in entering the AST specified in the ast 
parameter. 


If TF.NOT has been specified, after the AST has_ been 
effected, the AST becomes "disarmed" until a read request 
is issued by the’ task. If multiple unsolicited input 
characters are received before the read request is issued, 
they are stored in the type-ahead buffer of attached 
terminals until they are read by the task. Once the read 


Parameter 


parameter2 


ast2 
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Meaning 


request is received, the contents of the type-ahead 
buffer, including the character causing the AST, is 
returned to the task; the AST is then "armed" again for 


new unsolicited input characters. The terminal driver 
discards all unsolicited characters from an _ unattached, 
slaved terminal. If TF.NOT is not specified, every 


usolicited character causes an AST. 


Upon entry to the AST routines, the unsolicited character 
and parameter2 are in the top word on the stack, as shown 
in ast2. That word must be removed from the stack before 
exiting the AST. 


Parameter2 is located in the high byte of SP+00. It is a 
value that you can specify to identify individual 
terminals in a multiterminal environment. 


The entry point for an unsolicited CTRL/C AST. 


If you specify the ast2 parameter, an unsolicited CTRL/C 
character results in the task entering the AST specified 
in that parameter. If ast2 is not specified, an 
unsolicited CTRL/C results in the task entering the AST 
specified in the ast parameter. 


Upon entry to the AST routines, the unsolicited character 
and parameter2 are in the top word on the stack. That 
word must be removed from the stack before exiting the 
AST. The stack contents is shown next: 


SP+10 Event flag mask word 

SP+06 PS of task prior to AST 

SP+04 PC of task prior to AST 

SP+02 Task's directive status word 

SP+00 Unsolicited character in low byte; 


parameter2, in the high byte, is a 
user-specified value that can be used _ to 
identify individual terminals in a 
multiterminal environment 


Either ast2 or TF.XCC can be used, but not both in the 


same QIOS request. If you specify both in the request, an 
IE.SPC error is returned. 


After the AST has been effected, the AST becomes 
"disarmed" until a read request is issued by the task. If 
multiple characters are received before the read request 
is issued, they are stored in the type-ahead buffer. Once 
the read request is received, the contents of the 
type-ahead buffer, including the character causing the 
AST, is returned to the task; the AST is then "armed" 
again for new unsolicited input characters. Thus, using 
the TF.NOT subfunction allows a task to monitor more’ than 
one terminal for unsolicited input without the need to 
continuously read each terminal for possible unsolicited 
input. Note the the TF.NOT subfunction cannot be used 
with the CTRL/C AST; an unsolicited CTRL/C character 
flushes the type-ahead buffer. 


See the RSX-11M/M-PLUS and Micro/RSX Executive Reference 
Manual for further details on ASTs. 


2-14 
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Subfunction Bits: 


The subfunctions have the following meanings: 


Subfunction Meaning 


TF.ESQ 


TF.NOT 


TF.XCC 


Recognize Escape Sequences - This subfunction issued with 
IO.ATT or IO.ATA attaches a terminal and notifies the driver 


that it recognizes escape sequences’ entered at that 
terminal. Escape sequences are recognized for solicited 
input only (a read was issued to the terminal). (See 


Section 2.7 for a discussion of escape sequences.) 


If escape sequences are recognized, the sequence terminates 
input and a status code IS.ESC is returned. In addition, if 
uppercase to lowercase conversion is not enabled, the 
character ALTmode (codes 175 or 176, octal) is also treated 
as an escape character. 


If the terminal has not been declared capable of generating 
escape sequences, IO.ATA!ITF.ESQ has no effect other than 
attaching the terminal. No escape sequences are returned to 
the task because any ESC sent by the terminal acts as a line 
terminator. The QIOSC SF.SMC function or the DCL SET 
/ESCAPE command declare the terminal capable of generating 
escape sequences (see Table 2-4 in Section 2.4.14, and see 
also Section 2.7). 


Notification of Unsolicited Input - Unsolicited input causes 
an AST and entry into the AST service routine in the task. 
When the full-duplex terminal driver receives unsolicited 
terminal input (except CTRL/C) and you used the TF.NOT 
subfunction with IO.ATA, the resulting AST serves only as 
notification of unsolicited terminal input; the terminal 
driver does not pass the character to the task. Upon entry 
to the AST service routine, the high byte of the first word 
on the stack identifies the terminal causing the AST 
(parameter2 in the IO.ATA function). 


If TF.NOT is specified, after the AST has been affected, the 
AST becomes "disarmed" until a read request is issued by the 
task. If TF.NOT is not specified, every unsolicited 
character causes an AST. 


Using the TF.NOT subfunction allows a task to monitor more 
than one terminal for unsolicited input without the need to 
continuously read each terminal for possible unsolicited 
input. Note that the TF.NOT subfunction cannot be used with 
the CTRL/C AST (ast2 in I0.ATA); an unsolicited CTRL/C 
character flushes the type-ahead buffer. 


Exclude CTRL/C from AST Notification - You can use _ the 
TF.XCC subfunction with the IO.ATA function. When TF.XCC is 
included in the IO.ATA function, all characters (except 
CTRL/C) are handled in the manner previously described. 
CTRL/C marks the beginning of a command line interpreter 
(CLI) line that is processed by a CLI task, or, if CTRL/C 
abort is enabled, aborts tasks active at the terminal. None 
of the characters of CLI input, including the CTRL/C, are 
sent to the task issuing the function. 


Note that you can use either ast2 or TF.XCC, but not both in 
the same QIO request. If both are specified in the request, 
an, IE.SPC error is returned. 
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2.4.3 QIO$C I0.CCO - Cancel CTRL/O 

The QIO3 I0.CCO macro directs the driver to write a logical block of 
data to the terminal regardless of a CTRL/O condition that may be in 
effect. If CTRL/O is in effect, it is canceled before the write 
occurs. 

IO0.CCO is equivalent to IO.WLB!TF.CCO. 

The format of the QIO$ I0.CCO macro is as follows: 


QIO$C I0.cco ee ,lun, | efn | <stadd,size,vfc> 


{TF ..WBT , | pri 
, | isb 
, | ast 


Parameters: 


The parameters have the following meanings: 


Parameter Meaning 
lun The logical unit number of the associated physical device 
unit to be accessed by the I/0 request. For more 


information refer to Chapter l. 


efn The number of the event flag to be associated with the QIOS 
operation. For more information refer to Chapter 1. 


pri Makes this QIOS macro compatible with RSX-11D. Use a_ value 
of O or a null for this parameter. 


isb The address of the I/O status block (I/O status double-word) 
associated with the I/O request. For more information refer 
to Chapter l. 


ast If you want to interrupt your task to execute special code 
upon completion of this I/O request, you may specify ast. 
When this I/O request completes, control branches to the 
address specified by ast at the software priority of the 
requesting task. Omit ast or specify 0 to omit AST 
processing. 


stadd The starting address of the data buffer. Stadd may be on a 
byte boundary. 


size The size of the stadd data buffer in bytes. The specified 
size must be greater than 0 and less than or equal to 8128 
bytes. The buffer must be within the task's address space. 


vfc The terminal driver responds to task I/O requests for cursor 
positioning without the task requiring information about the 
type of terminal in use. 


The vfc parameter specifies cursor position. The parameter 
is interpreted as a vfc parameter if the high byte of the 
parameter is 0. However, if the parameter defines cursor 
position, the high byte must be nonzero, the low byte is 
interpreted as column number (x-coordinate), and the high 
byte is interpreted as line number (y-coordinate). Home 
position, the upper left corner of the display, is defined 


Parameter 
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Meaning 


as l,l. The driver outputs cursor-positioning commands 
appropriate for the terminal in use that move the cursor to 
the specified position. If the most significant bit of the 
line number is set, the driver clears the display before 
positioning the cursor. 


Table 2-9 is a summary of all characters that your task can 
use for vertical format control on the terminal. Any one of 
these characters can be specified as the value of the vfc 
parameter. 


Subfunction Bits: 


The subfunctions have the following meanings: 


Subfunction Meaning 


TF.WAL 


TE .WBT 


Write All Characters - During the write-pass-all operation 
specified by this subfunction (as in IO.WAL or 
IO.WLB!TF.WAL), the terminal driver outputs characters 
without interpretation. It does not intercept control 
characters and it does not keep track of cursor position. 
Long lines are not wrapped around if input/output wraparound 
has been selected. 


Write Breakthrough - Instructs the driver to write the 
buffer regardless of the I/0 status of the receiving 
terminal. If another write function is currently in 
progress, it finishes the current request and the write 
breakthrough is the next write issued. Therefore, the 
TF .WBT subfunction cannot break through another write 
breakthrough that is in progress. The effect of this is 
that a CTRL/S can stop write breakthrough functions. Thus, 
it may be desirable for tasks to time out on breakthrough 
operations. 


If a read is currently posted, the breakthrough write 
proceeds, and an automatic CTRL/R is performed to redisplay 
any input that was received before the breakthrough write 
was effected (if the terminal is not in the full-duplex 
mode). 


CTRL/O, if in effect, is canceled. 
An escape sequence that was interrupted is rubbed out. 


Break-through write may be issued by a privileged task only. 
(The DCL command BRO (broadcast) uses IO.WBT.) 
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2.4.4 QIOSC IO.EIO - Extended I/O Functions 


The IO.EIO function allows the use of additional I/0 subfunctions. 
The QIOS design as used with the other QIOS$ functions allows a limited 
number of I/O subfunctions to be implemented. With I0O.EIO, the 
address of an item list buffer (stadd) is contained in the macro 
statement. The item list buffer contains IO.EIO modifiers 
(recognizable as subfunctions) and it allows the use of a maximum of 
two words of new I/O subfunction bits. Figure 2-1 shows the structure 
of the Item List 1 buffer required for the subfunction TF.RLB. Also, 
Figure 2-2 shows the structure of the Item List 2 buffer required for 
the subfunction TF.WLB. 


The QIOSC IO.EIO reads from or writes to a terminal. The modifiers in 
the item list allow you to modify the nature or operation of that read 
or write. A read (TF.RLB) subfunction or write (TF.WLB) subfunction 
must 9e issued with the I0.EIO. function. But both of these 
subfunctions cannot be used in a Logical OR together. 


‘NOTE 
The IO.EIO function will not work if your terminal has 
been set aS a remote terminal (RT:) to another system. 
That is, after entering 
>SET HOST xxxxx 

and logging into an RT:, the terminal driver will 
reject a QIO issuing an extended I/0 request from the 
RT:. 

The QIOSC IO.EIO macro has either one of the following formats: 


QIOSC IO.EIO!TF.RLB,lun,} efn | ,<stadd,size> 


,| pri 
,| isb 
7} ast 


QIOSC IO.EIO!TF.WLB,lun,| efn | ,<stadd,size> 


,| pri 
,| isb 
,{| ast 


The TF.WLB and TF.RLB subfunctions each allow specific modifiers, 
which are located in the item list, to be used with them. They are 
listed as follows: 


Subfunction Modifiers 
TF.RLB TF.BIN, TF.RAL, TF.RDI, TF.RES, 
TF.RLU, TE.RNE, TF.RNF, TF .RPR, 
TF.RPT, TF.RST,. TE.RTT,1 ‘TE.TMO, 
TE.TNE, TF .XOF 
TF .WLB TF.CCO, TF.RCU, TF .WAL, TF .WBT, 
TF WIR 
1. If both the TF.RST and TF.RTT modifiers are included, TF.RST 


supersedes the function of TF.RTT. 


Parameters: 


The parameters have the following meanings: 


Parameter 


lun 


efn 


pri 


isb 


ast 


stadd 


size 
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Meaning 


The logical unit number of the associated physical device 
unit to be accessed by the I/0 request. For more 
information refer to Chapter l. 


The number of the event flag to be associated with the QIO$ 
operation. For more information refer to Chapter l. 


Makes this QIOS$S macro compatible with RSX-11D. Use a_ value 
of 0 or a null for this parameter. 


The address of the I/O status block (1/0 status double-word) 
associated with the I/O request. For more information refer 
to Chapter l. 


If you want to interrupt your task to execute special code 
upon completion of this I/O request, you may specify ast. 
When this I/O request completes, control branches to the 
address specified by ast at the software priority of the 
requesting task. Omit ast or specify 0O to omit AST 
processing. 


The starting address of the item list of the length 
specified in size. The address of the item list must be 
word-aligned and in the task's address space. 


The size of the item list in bytes. The specified size for 
the IO.EIO!ITF.RLB function must be 24 decimal bytes. The 
specified size for the IO.EIO!ITF.WLB function must be 10 
decimal bytes. The item list must be within the task's 
address space. 


Subfunction Bits: 


The subfunctions have the following meanings: 


Subfunction Meaning 


TF.BIN 


TF.CCO 


TF.RAL 


Binary Prompt (send prompt as pass all) - The prompt is sent 
to the terminal without interpretation by the driver. This 
is similar, for the prompt, to a write-pass-all. 


Cancel CTRL/O - The driver writes a logical block of data to 
the terminal of data to the terminal regardless of a CTRL/O 
condition that may be in effect. The CTRL/O, if in effect, 
is canceled before the write occurs. 


Read All Characters (Pass All) - Allows the passage of all 
characters to the requesting task. The driver does not 
intercept control characters. The characteristic TC.8BC, 
when set, allows the driver to pass 8 bits. For example, 
CTRL/C, CTRL/Q, CTRL/S, CTRL/O, and CTRL/Z are passed to the 
task and not interpreted by the driver. 
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Subfunction Meaning 


TF.RCU 


TF.RDI 


TF.RES 


TFE.RLU 


TF.RNE 


TF.RNF 


TF.RPR 


Restore Cursor Position - When defining cursor position in a 
function, you can use the TF.RCU subfunction to save the 
current cursor position. When included in this’ manner, 
TF.RCU causes the driver to first save the current cursor 
position, then position the cursor and output the specified 
buffer, and, finally, restore the cursor to the original 
(saved) position once the output transfer has been 
completed. 


Read With Default Input - The default input that you 
specified in the extended I/O item list is displayed at the 
start of the read as an input line on the terminal. You may 
change this line or use it as input to the system. This 
subfunction is for the extended I/O function (IO.EIO) only. 


Read With Escape Sequence Processing Enabled - This 
subfunction enables escape sequence recognition for the read 
operation in extended I/O and is effective for one read 
only. . 


Read With Conversion From Lowercase to Uppercase - The task 
that uses this subfunction gets input in the buffer in upper 
case. This subfunction is used with the extended I/0 
(IO.EIO) function only. 


Read With No Echo - Reads terminal input characters without 
echoing the characters back to the terminal for immediate 
display. You can use this feature when typing sensitive 
information. CTRL/R is ignored while Read With No Echo is 
in progress. 


Read With No Filter - Read and pass through CTRL/U, CTRL/R, 
and DELETE characters as normal characters. This 
subfunction is for use with the extended I/0 (I0.EIO) 
function only. 


Read After Prompt (for extended I/0 (IO.EIO) function 
only) - The TEF.RPR subfunction causes a prompt to be sent to 
the terminal and immediately follows it with a read function 
at the terminal. The TF.RPR functions as an IO.WLB (to 
write a prompt to the terminal) followed by IO.RLB. 
However, TF.RPR differs from the combination of those two 
functions as follows: 


e System overhead is lower with the TF.RPR because only one 
QIOS is processed. 


e When using the TF.RPR function, there is no "“window" 
during which a response to the prompt may be ignored. 
Such a window occurs if the task uses IO.WLB followed by 
an I0O.RLB, because no read may be posted at the time the 
response is received. 


e If the issuing task is checkpointable, it can be 


checkpointed during both the prompt and the read 
requested by the TF.RPR. 


e A CTRL/O that may be in effect prior to issuing the 
TF.RPR is canceled before the prompt is written. 


TF.RPT 


TF.RST 


TF.RTT 


TE.TMO 
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NOTE 


If an TF.RPR function is in progress when the driver 
receives a CTRL/R or CTRL/U, the prompt is 
redisplayed. 


Read In Pass-Through Mode - Passes all characters except 
XON/XOFF. The characteristic TC.8BC, when set, allows the 
driver to pass eight bits instead of 7. The driver 
intercepts the control characters CTRL/S and CTRL/Q. Other 
control characters, for example, CTRL/C, CTRL/O, and CTRL/Z, 
are passed to the task and nat interpreted by the driver. 
This subfunction modifier is for use with the IO.EIO!IO.RLB 
function only. 


Read With Special Terminators - Certain special characters 
terminate the read. These characters are in the ranges 
0-037 and 175-177. The driver does not interpret the 
terminating character. For example, a DELETE or RUBOUT 
(177) does not erase, and a CTRL/C does not produce a CLI 
prompt. Also CTRL/U and CTRL/R do not perform their usual 
functions. All control characters are terminators. 


TF.RST sets TF.TNE by default, which means that terminators 
are not echoed on the terminal screen. 


If uppercase to lowercase conversion is disabled, characters 
175 and 176 do not act as terminators. CTRL/O, CTRL/Q, and 
CTRL/S (017, 021, and 023, respectively) are not special 
terminators. The driver interprets them as output control 
characters in a normal manner. 


Read With Specified Terminator Table - Use this subfunction 
with the IO.EIO extended I/0 function only. Control 
characters function normally with this subfunction. 


Terminators echo by default. The additional use of 
subfunction TF.TNE prevents the echoing of terminators. on 
the terminal screen. If you want to use special control 


characters as terminators, their normal function should be 
disabled with the TF.RNF subfunction or the TC.PTH 
characteristic. The terminator table (a bit mask _ table) 
length can be from 1 through 32(decimal) bytes where bit 0 
is a null character, bit 1 is a CTRL/A, and so. forth. The 
terminator table address is in the item list of the IO.EIO 
function. To use ASCII characters 128 through 255(decimal), 
the charateristic TC.8BC must be set. 


Read With Time-Out - This subfunction allows the use of the 
tmo parameter to require input from the terminal within a 
specified time. 


Specify the time-out count in seconds. Time-out is the 
maximum time allowed between two input characters before the 
read is aborted. The maximum time-out value is 255 (decimal) 
intervals. 
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Subfunction Meaning 


TF.TMO 
(Cont. ) 


TF.TNE 


TF .WAL 


TF .WBT 


TF.WIR 


TF.XOF 


If 0 is specified, the read times out immediately after 
reading any data that may be in the type-ahead buffer. In 
other words, if you enter a 0, no time is allowed for you to 
enter characters, and all characters are read from the 
type-ahead buffer. 


If you need more than 255(decimal) seconds for IO.EIO, issue 
an asynchronous QIOS request followed by a Mark Time 
directive (MRKTS) for the required interval. Specify 
different event flags in the two directives and, after 
issuing them, wait for the Logical OR of the two event 
flags. 


Read Terminators With No Echo - Allows reading terminator 
characters from the terminal without their being echoed on 
the terminal screen as they are entered. Use this 
subfunction with the extended I/O function IO.EIO. 


Write All Characters - During the write-pass-all operation 
specified by this subfunction (as in IO.WAL Or 
IO.WLB!ITF.WAL), the terminal driver outputs characters 
without interpretation. It does not intercept control 
characters and it does not keep track of cursor position. 
Long lines are not wrapped around if input/output wraparound 
has been selected. 


Write Breakthrough - Instructs the driver to write the 
buffer regardless of the I/0 status of the receiving 
terminal. If another write function is currently in 
progress, it finishes the current request and the write 
breakthrough is the next write issued. Therefore, the 
TF .WBT subfunction cannot break through another write 
breakthrough that is in progress. The effect of this is 
that a CTRL/S can stop write breakthrough functions. Thus, 
it may be desirable for tasks to time out on _ breakthrough 
operations. 


If a read is currently posted, the breakthrough write 
proceeds, and an automatic CTRL/R is performed to redisplay 
any input that was received before the breakthrough write 
was effected (if the terminal is not in the full-duplex 
mode). 


CTRL/O, if in effect, is canceled. 
An escape sequence that was interrupted is rubbed out. 
Break-through write may be issued by a privileged task only. 


Write With Input Redisplayed - Performs a write to the 
terminal. If a read is in progress at the terminal and you 
have entered characters in the input line, the prompt’ and 
the characters are redisplayed at the end of the write. 


Send XOFF - The driver sends an XOFF to the terminal after 
its read. The XOFF (CTRL/S) may have the effect of 
inhibiting input from the terminal, if the terminal 
recognizes XOFF for this purpose. TF.XOF is ignored when 
full-duplex I/O is in use. 
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2.4.4.1 Item List 1 for IO.EIO!ITF.RLB - The structure of the Item 
List 1 Buffer is shown in Figure 2-1. Modifier word 2 is currently 
not used but must be zero. All the other fields in the item list must 
be present, but need not contain any specific information except that 
pertinent to the function being performed. Thus, if a read with 
prompt (TF.RPR) is not being performed, words 10, 12 and 14 are not 
used. Item List 1 has the following form: 


Octal Decimal 


ZK-4079-85 


Figure 2-1 Structure of the Item List 1 Buffer 


Modifiers (subfunctions) of the group of 
modifiers allowed for any I/0 read function. 


Currently must be zero. 


The starting address of the read data buffer. 
The read data buffer may be on a byte boundary. 


The size of the read data buffer in bytes. The 
specified size must be greater than 0 and less 
than or equal to 8128 bytes. The buffer must be 
within the task's address space. 


For use with TF.TMO. TF.TMO must be in modifier 
word l. 


This field contains the starting address of the 


prompt buffer. The prompt buffer may be ona 
byte boundary. For use with TF.RPR, which must 
be in modifier word l. 


@ For use with TF.RPR. The size of the prompt 
buffer in bytes. The buffer must be within the 
task's address space. The specified size must be 
greater than 0 and =1less than or equal to 8128 
bytes. 
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@ For use with TF.RPR. The vfc parameter specifies 
cursor position. The parameter is interpreted as 
a vfc parameter if the high byte of the parameter 


is 0. However, if the parameter defines cursor 
position, the high byte must be nonzero, the low 
byte is interpreted as column number 


(x-coordinate), and the high byte is’ interpreted 
aS line number (y-coordinate). Home position, 
the upper left corner of the display, is defined 
as 1,l. The driver outputs cursor-positioning 
commands appropriate for the terminal in use that 
move the cursor to the specified position. If 
the most significant bit of the line number is 
set, the driver clears the display before 
positioning the cursor. 


Table 2-9 is a summary of all characters that 
your task can use for vertical format control on 
the terminal. Any one of these characters can be 
specified as the value of the vfc parameter. 


@ For use with TF.RTT. TE.RTT must be in modifier 
word 1. The table (1 to 32(decimal) bytes) 
starts at the address specified by the table 
address. The first word contains bits that 
represent the first 16 ASCII character codes 
(0-17); similarly, the second word contains bits 
that represent the next 16 character codes 
(20-37), and so forth, through the sixteenth 
word, bit 15, which represents character code 
377. For example, to specify the % symbol (code 
045) as a read terminator character, set bit 05 
in the third word, because the third word of the 
table contains bits representing character codes 
40-57. 


The terminal must be set to read-pass-all 
operation (TC.BIN=1), or read-pass 8-bits 
(TC.8BC) if you want to use any of the following 
characters as terminator characters: 


e CTRL/S (023) 
e CTRL/Q (021) 


@e Any characters whose codes are greater than 
177 


@ Length of the terminator table specified in I. 


@ For use with TF.RDI. TF.RDI must be in modifier 
word 1. This buffer contains the default input 
that is to be displayed on the terminal. 


@ For use with TF.RDI. This word contains the 
length of the buffer at the address specified in 
K. 


2.4.4.2 
List 


present. 
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Item List 2 for IO.EIO!ITF.WLB - The 
2 Buffer 
not used but must be 0. 


is shown in Figure 


structure of 
2-2. 


Item list 2 is shown in Figure 2-2. 


Octal ‘ Decimal 
1 0 
° 
3 2 
° 
5 4 
° 
7 6 
0 
4 8 
0 
ZK-4080-85 
Figure 2-2 Structure of the Item List 2 Buffer 
@ Modifiers (subfunctions) of the group of 
additional modifiers allowed for I/0 write 
functions. 
@ currently must be zero. 
The starting address of the write data buffer. 
The address may be on a byte boundary. 
The size of the stadd buffer in bytes. The 
specified size must be greater than 0 and less 


than or equal to 8128 bytes. 


The buffer must be 


within the task's address space. 


@ The vfc parameter specifies cursor position. 
is interpreted 
the high byte of the parameter is 0. 
defines cursor position, the high 


parameter 


the parameter 


The 
as a vfc parameter if 
However, if 


byte must be nonzero, the low byte is interpreted 


as column number 
byte is 
(y-coordinate). Home 
corner of the display, 


driver outputs 


(x- 
interpreted as 


cursor-positioning 


and the high 
line number 
the upper left 
Lyk. The 
commands 


coordinate), 


position, 
is defined as 


appropriate for the terminal in use that move the 


cursor to the 
significant bit of the 
driver 
cursor. 


Table 2-9 is a summary 
your task can use for 
the terminal. Any one 
specified as the value 


specified position. 


If the most 


line number is set, the 


clears the display before positioning the 


of all characters’ that 

vertical format control on 
of these characters can be 
of the vfc parameter. 


the 
Modifier word 2 is currently 
All the other fields in the item list must be 


Item 
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2.4.5 QIOSC I0.GTS - Get Terminal Support 


This function is a get terminal support request that returns 
information to a 4-word buffer specifying which features are part of 
the terminal driver. Only two of these words are currently defined. 
Table 2-3 gives details for these words. 


The format of the QIOSC IO.GTS macro is as follows: 
CIOSC 10.GTS,lun,[efn],[pri],[isb],{ast],<stadd,size> 
Parameters: 
The parameters have the following meanings: 
Parameter Meaning 


lun The logical unit number of the associated physical device 
unit to be accessed by the I/0 request. For more 
information refer to Chapter l. 


efn The number of the event flag to be associated with the QIOS 
operation. For more information refer to Chapter l. 


pri Makes this QIOS macro compatible with RSX-11D. Use a value 
of 0 or a null for this parameter. 


isb The address of the I/O status block (I/O status double-word) 


associated with the I/O request. For more information refer 
to Chapter l. 


ast If you want to interrupt your task to execute special code 
upon completion of this I/O request, you may specify ast. 
When this I/O request completes, control branches to _ the 
address specified by ast at the software priority of the 
requesting task. Omit ast or specify 0 to omit AST 
processing. 


stadd The starting address of the data buffer. The address must 
be word aligned. 


size The size of the stadd data buffer in bytes. The specified 
size must be four bytes. The buffer must be within the 
task's address space. The size must be an even value. 


The various symbols used by the I0.GTS, SF.GMC, and SF.SMC functions 
are defined in a system module, TTSYM. These symbols include F1.xxx 
and F2.xxx (Table 2-3); TC.xxx (Table 2-4); T.xxxx (Table 2-5); and 
the SE.xxx status returns described in Table 2-6, Section 2.5. These 
symbols may be defined locally within a code module by using: 


.~MCALL TTSYMS 


TTSYMS 


Symbols that are not defined locally are automatically defined by the 
Task Bailder. 


Octal values shown for the symbols are subject to change. Therefore, 
it is recommended that only the symbolic names be used. 


Bit 


Information Returned by Get Terminal Support 


Octal 
Value 
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Mnemonic 


Word 0 of Buffer: 


15 


a 
2 
4 
10 
20 
40 


100 
200 
400 
1000 
2000 
4000 
10000 
20000 
40000 


100000 


F1.ACR 
F1.BTW 
F1.BUF 
F1.UIA 
F1.CCO 
F1.ESQ 


F1.HLD 
F1.LWC 
F1.RNE 
F1.RPR 
F1.RST 
F1.RUB 
F1.SYN 
F1.TRW 
F1.UTB 


Fl. VBF 


Word 1 of Buffer: 


WO ODTIA US WNP © 


F2.SCH 
F2.GCH 
F2.DCH 
F2.DKL 
F2.ALT 
F2.SFF 
F2.CUP 
F2.FDX 
F2.EIO 
F2.NCT 


Table 2-3 
(IO0.GTS) QIOS 


Meaning When Set to l 


Automatic CR/LF on long lines 
Breakthrough write 

Checkpointing during terminal input 
Unsolicited-input-character AST 

Cancel CTRL/O before writing 

Recognize escape sequences in solicited 
input 

Hold-screen mode 

Lowercase to uppercase conversion 

Read with no echo 

Read after prompting 

Read with special terminators 

CRT rubout 

CTRL/R terminal synchronization 

Read all and write all 

Input characters buffered in task's address 
space 

Variable-length terminal buffers 


Set characteristics QIOS$ (SF.SMC) 
Get characteristics QIOS (SF.GMC) 
Dump/restore characteristics 
Historical 11D/IAS I10.KIL 
ALTmode is echoed 

Formfeed can be simulated 

Cursor positioning 

Full-duplex terminal driver 
Extended I/0 

Network command terminal support 
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2.4.6 QIO$C IO.HNG - Disconnect a Terminal 


The QIOSC IO.HNG macro disconnects a terminal that is on a remote line 
or on a DECNET link. This function has no parameters. 


A nonprivileged task can issue an IO.HNG request for its own terminal 
(TI:) only. A privileged task can issue IO.HNG to any terminal. 


The format of the QIOSC IO.HNG macro is as follows: 
Qrosc IO.HNG,1lun,efn,pri,isb,ast 
Parameters: 


The parameters have the following meaning: 


Parameter Meaning 
lun The logical unit number of the associated physical device 
unit to be accessed by the I/0 request. For more 


information refer to Chapter l. 


efn The number of the event flag to be associated with the QI0$ 
operation. For more information refer to Chapter l. 


pri Makes this QIOS$ macro compatible with RSX-11D. Use a value 
of 0 or a null for this parameter. 


isb The address of the I/O status block (I/O status double-word) 
associated with the I/O request. For more information refer 
to Chapter l. 


ast If you want to interrupt your task to execute special code 
upon completion of this I/O request, you may specify ast. 
When this 1/0 request completes, control branches to the 
address specified by ast at the software priority of the 
requesting task. Omit ast or specify 0 to omit AST 
processing. 
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2.4.7 QIO$C IO.RAL - Read all Characters Without Interpretation 


The QIOSC IO.RAL macro causes the driver to pass all characters’ that 
were read to the requesting task. The driver does not intercept 
control characters. For example, CTRL/C, CTRL/Q, CTRL/S, CTRL/O, and 
CTRL/Z are passed to the program and are not interpreted by the 
driver. 


NOTE 
IO.RAL echoes the characters that are read. To read 


all characters without echoing, use I10.RAL!TF.RNE. 


IO.RAL is equivalent to IO.RLB in a Logical OR with the  subfunction 
bit TF.RAL. The I0.RAL function can be terminated by a full character 
count only (input buffer full). 


The format of QIOSC IO.RAL is as follows: 


QIosc IO.RAL]| !TF.RNE | ,lun, | efn | ,<stadd,size, [tmo]> 


ITF RST , | pri 
!TF.TMO , | isb 
ITF. XOF , | ast 


Parameters: 


The parameters have the following meanings: 


Parameter Meaning 
lun The logical unit number of the associated physical device 
unit to be accessed by the I/0 request. For more 


information refer to Chapter l. 


efn The number of the event flag to be associated with the QIO$ 
operation. For more information refer to Chapter l. 


pri Makes this QIO$ macro compatible with RSX-11D. Use a_ value 
of 0 or a null for this parameter. 


isb The address of the I/O status block (I/O status double-word) 
associated with the I/O request. For more information refer 
to Chapter 1. 


ast If you want to interrupt your task to execute special code 
upon completion of this I/O request, you may specify ast. 
When this I/O request completes, control branches to. the 
address specified by ast at the software priority of the 
requesting task. Omit ast or specify 0 to omit AST 
processing. 


stadd The starting address of the data buffer. Stadd may be on a 
byte boundary. 


size The size of the stadd data buffer in bytes. The specified 
size must be greater than 0 and less than or equal to 8128 
bytes. The buffer must be within the task's address space. 


tmo The optional time-out count for use with the TF.TMO 
subfunction. 
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Subfunction Bits: 


The subfunctions have the following meanings: 


Subfunction Meaning 


TF .RNE 


TF.RST 


TF .TMO 


TF. XOF 


Read With No Echo — Reads terminal input characters without 
echoing the characters back to the terminal for immediate 
display. You can use this feature when typing sensitive 
information. CTRL/R is ignored while Read With No Echo is 
in progress. 


Read With Special Terminators - Certain special characters 
terminate the read. These characters are in the ranges 
0-037 and 175-177. The driver does not interpret the 
terminating character. For example, a DELETE or RUBOUT 
(177) does not erase, and a CTRL/C does not produce a CLI 
prompt, or, if CTRL/C abort is enabled, abort tasks active 
at the terminal. Also CTRL/U and CTRL/R do not’ perform 
their usual functions. All control characters are 
terminators. 


TF.RST sets TF.TNE by default, which means that terminators 
are not echoed on the terminal screen. 


If uppercase to lowercase conversion is disabled, characters 
175 and 176 do not act as terminators. CTRL/O, CTRL/Q, and 
CTRL/S (017, 021, and 023, respectively) are not special 
terminators. The driver interprets them as output control 
characters in a normal manner. 


Exercise great care when using IO.RAL and TF.RST together. 
Obscure problems can result if you use them in this way. 


Read With Time-Out - This subfunction allows the use of the 
tmo parameter to require input from the terminal within a 
specified time. 


Specify the time-out count in 10-second intervals. Time-out 
is the maximum time allowed between two input characters 
before the read is aborted. The maximum time-out value is 
255(decimal) intervals. 


If 0 is specified, the read times out immediately after 
reading any data that may be in the type-ahead buffer. In 
other words, if you enter a 0, no time is allowed for you to 
enter characters, and all characters are read from the 
type-ahead buffer. 


If you need more than 255(decimal) intervals, issue an 
asynchronous QIOS$ request followed by a Mark Time directive 
(MRKTS) for the required interval. Specify different event 
flags in the two directives and, after issuing them, wait 
for the Logical OR of the two event flags. 


Send XOFF - The driver sends an XOFF to the terminal after 
its read. The xXOFF (CTRL/S) may have the effect of 
inhibiting input from the terminal, if the terminal 
recognizes XOFF for this purpose. TF.XOF is ignored when 
full-duplex I/0 is in use. 
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2.4.8 QIOS$C IO.RNE - Read Input Without Echoing 

The IO.RNE function reads terminal input characters without echoing 
the characters back to the terminal for immediate display. You can 
use this feature when typing sensitive information (for example, a 
password or combination). 


(Note that the no-echo mode can also be selected with the SF.SMC 
function; see Table 2-4, bit TC.NEC.) 


CTRL/R is ignored while an IO.RNE is in progress. 


The I0.RNE function is equivalent to IO.RLB in a Logical OR with the 
subfunction bit TF.RNE. 


The format of the QIOSC IO.RNE macro is as follows: 


QIOSC IO.RNE| !TF.RAL [| ,lun, | efn | ,<stadd,size,,([tmo]> 


ITF .RST , | pri 
!TF.TMO , | isb 
ITF. XOF , | ast 


Parameters: 
The parameters have the following meanings: 
Parameter Meaning 


lun The logical unit number of the associated physical device 


unit to be accessed by the I/0 request. For more 
information refer to Chapter l. 


efn The number of the event flag to be associated with the QIOS§ 
operation. For more information refer to Chapter l. 


pri Makes this QIOS macro compatible with RSX-11D. Use a_ value 
of 0 or a null for this parameter. 


isb The address of the I/O status block (I/O status double-word) 
associated with the I/O request. For more information refer 
to Chapter 1l. 


ast If you want to interrupt your task to execute special code 
upon completion of this I/O request, you may specify ast. 
When this I/O request completes, control branches to the 
address specified by ast at the software priority of the 
requesting task. Omit ast or specify 0 to omit AST 
processing. 


stadd The starting address of the data buffer. Stadd may be on a 
byte boundary. 


size The size of the stadd data buffer in bytes. The specified 


size must be greater than 0 and less than or equal to 8128 
bytes. The buffer must be within the task's address space. 


tmo The optional time-out count for use with the TF.TMO 
subfunction. 


FULL-—DUPLEX TERMINAL DRIVER 


Subfunction Bits: 


The subfunctions have the following meanings: 


Subfunction Meaning 


TF .RAL 


TE.RST 


TF.TMO 


TF.XOF 


Read All Characters (Pass All) - The driver passes all 
characters to the requesting task. The characteristic 
TC.8BC, when set, allows the driver to pass eight bits. For 
example, CTRL/C, CTRL/Q, CTRL/S, CTRL/O, and CTRL/Z are 
passed to the task and not interpreted by the driver. 


Exercise great care when uSing TF.RAL (read all) and TF.RST 
(read with special terminators) together. Obscure problems 
can result if you use them in this way. 


Read With Special Terminators - Certain special characters 
terminate the read. These characters are in the ranges 
0-037 and 175-177. The driver does not interpret the 
terminating character. For example, a DELETE or RUBOUT 
(177) does not erase, and a CTRL/C does not produce a CLI 
prompt, or, if CTRL/C abort is enabled, abort tasks active 
at the terminal. Also CTRL/U and CTRL/R do not’ perform 
their usual functions. All control characters are 
terminators. 


TF.RST sets TF.TNE by default, which means that terminators 
are not echoed on the terminal screen. 


If uppercase to lowercase conversion is disabled, characters 
175 and 176 do not act as terminators. CTRL/O, CTRL/Q, and 
CTRL/S (017, 021, and 023, respectively) are not special 
terminators. The driver interprets them as output control 
characters in a normal manner. 


Exercise great care when using TF.RAL (read all) and TF.RST 
(read with special terminators) together. Obscure problems 
can result if you use them in this way. 


Read With Time-Out - This subfunction allows the use of the 


tmo parameter to require input from the terminal within a 
specified time. 


Specify the time-out count in 10-second intervals. Time-out 
is the maximum time allowed between two input characters 
before the read is aborted. The maximum time-out value is 
255(decimal) intervals. 


If 0 is specified, the read times out immediately after 
reading any data that may be in the type-ahead buffer. In 
other words, if you enter a 0, no time is allowed for you to 
enter characters, and all characters are read from the 
type-ahead buffer. 


If you need more than 255(decimal) intervals, issue an 
asynchronous QIOS$ request followed by a Mark Time directive 
(MRKTS$) for the required interval. Specify different event 
flags in the two directives and, after issuing them, wait 
for the Logical OR of the two event flags. 


Send XOFF - The driver sends an XOFF to the terminal after 
its read. The XOFF (CTRL/S) may have the effect of 
inhibiting input from the terminal, if the terminal 
recognizes XOFF for this purpose. TF.XOF is ignored when 
full-duplex I/O is in use. 
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2.4.9 QIO$C IO.RPR - Send Prompt, Then Issue Read 


The QIOSC IO.RPR (Read After Prompt) macro sends a prompt to the 
terminal and immediately follows it with a read function at the 
terminal. The IO0.RPR functions as an IO.WLB (to write a prompt to the 
terminal) followed by I0O.RLB. However, I0O.RPR differs from the 
combination of those two functions as follows: 


e System overhead is lower with the IO.RPR because only one QIOS 
is processed. 


@e When using the IO.RPR function, there is no "“window" during 
which a response to the prompt may be ignored. Such a window 
occurs if the task uses IO.WAL/IO.RLB, because no read may be 
posted at the time the response is received. 


e If the issuing task is checkpointable, it can be checkpointed 
during both the prompt and the read requested by the IO.RPR. 


e A CTRL/O that may be in effect prior to issuing the IO.RPR is 
canceled before the prompt is written. 


Subfunction bits may be used in a Logical OR with IO.RPR to write the 
prompt as a Write All (TF.BIN) and to_ send XOFF after the read 
(TF.XOF). In addition, your task can use read subfunction bits 
TF.RAL, TF.RNE, TE.TMO, and TF.RST with IO.RPR. 
NOTE 
If an IO.RPR function is in progress when the driver 
receives a CTRL/R or CTRL/U, the prompt is 
redisplayed. 
The format of the QIOSC IO.RPR macro is as follows: 


QrOosc IO.RPR| !TF.BIN | ,lun, | efn | ,<stadd,size, [tmo] ,pradd,prsize,vfc> 


ITF. RAL , | pri 
ITF. RNE , | isb 
1TF.RST , | ast 
'TF.TMO 
ITF .XOF 


Parameters: 
The parameters have the following meanings: 
Parameter Meaning 


lun The logical unit number of the associated physical device 
unit to be accessed by the I/0 request. For more 
information refer to Chapter l. 


efn The number of the event flag to be associated with the QIO$ 
operation. For more information refer to Chapter l. 


pri Makes this QIOS macro compatible with RSX-11D. Use a_ value 
of 0 or a null for this parameter. 


isb The address of the I/O status block (I/O status double-word) 
associated with the I/O request. For more information refer 
to Chapter l. 


Parameter 


ast 


stadd 


size 


tmo 


pradd 


prsize 


vfc 
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Meaning 


If you want to interrupt your task to execute special code 
upon completion of this I/O request, you may specify ast. 
When this I/O request completes, control branches to the 
address specified by ast at the software priority of the 
requesting task. Omit ast or specify 0 to omit AST 
processing. 


The starting address of the data buffer. Stadd may be on a 
byte boundary. 


The size of the stadd data buffer in bytes. The specified 
size must be greater than 0 and less than or equal to 8128 
bytes. The buffer must be within the task's address space. 


The optional time-out count for use with the TF.TMO 
subfunction,. 


The starting address of the byte buffer where the prompt is 
stored. . 


The size of the pradd prompt buffer in bytes. The specified 
size must be greater than 0 and less than or equal to 8128 
bytes. The buffer must be within the task's address space. 


The terminal driver responds to task I/O requests for cursor 
positioning without the task requiring information about the 
type of terminal in use. 


The vfc parameter specifies cursor position. The parameter 
is interpreted as a vfc parameter if the high byte of the 
Parameter is 0. However, if the parameter defines cursor 
position, the high byte must be nonzero, the low byte is 
interpreted as column number (x-coordinate), and the high 
byte is interpreted as line number (y-coordinate). Home 
position, the upper left corner of the display, is defined 
as l,l. The driver outputs cursor-positioning commands 
appropriate for the terminal in use that move the cursor’ to 
the specified position. If the most significant bit of the 
line number is set, the driver clears the display before 
positioning the cursor. 


Table 2-9 is a summary of all characters that your task can 
use for vertical format control on the terminal. Any one of 
these characters can be specified as the value of the vfc 
parameter. 
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Subfunction Bits: 


The subfunctions have the following meanings: 


Subfunction Meaning 


TF.BIN 


TF.RAL 


TE .RNE 


TF.RST 


Binary Prompt (send prompt as pass all) - As used in IO.RPR, 
results in a "binary" prompt; that is, a prompt is sent to 
the terminal by the driver with no character interpretation 
(as if it were issued as an IO.WAL). The read follows the 
binary prompt. 


Read All Characters (Pass All) - The driver passes all 
characters to the requesting task. The characteristic 
TC.8BC, when set, allows the driver to pass eight bits. For 
example, CTRL/C, CTRL/Q, CTRL/S, CTRL/O, and CTRL/Z are 
passed to the task and not interpreted by the driver. 


Exercise great care when using TF.RAL (read all) and TF.RST 
(read with special terminators) together. Obscure problems 
can result if you use them in this way. 


Read With No Echo- -Reads terminal input characters without 
echoing the characters back to the terminal for immediate 
display. You can use this feature when typing sensitive 
information. CTRL/R is ignored while Read With No Echo is 
in progress. 


Read With Special Terminators - Certain special characters 
terminate the read. These characters are in the ranges 
0-037 and 175-177. The driver does not interpret the 
terminating character. For example, a DELETE or RUBOUT 
(177) does not erase, and a CTRL/C does not produce a CLI 
prompt, or, if CTRL/C is enabled, abort tasks active at the 
terminal. Also CTRL/U and CTRL/R do not perform their usual 
functions. All control characters are terminators. 


TF.RST sets TF.TNE by default, which means that terminators 
are not echoed on the terminal screen. 


If uppercase to lowercase conversion is disabled, characters 
175 and 176 do not act as terminators. CTRL/O, CTRL/Q, and 
CTRL/S (017, 021, and 023, respectively) are not special 
terminators. The driver interprets them as output control 
characters in a normal manner. 


Exercise great care when uSing Real All and Read With 


Special Terminators together. Obscure problems can result 
if you use them in this way. 
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Subfunction Meaning 


TE .TMO 


TF .XOF 


Read With Time-Out - This subfunction allows the use of the 
tmo parameter to require input from the terminal within a 
specified time. 


Specify the time-out count in 10-second intervals. Time-out 
is the maximum time allowed between two input characters 
before the read is aborted. The maximum time-out value is 
255(decimal) intervals. 


If 0 is specified, the read times out immediately after 
reading any data that may be in the type-ahead buffer. In 
other words, if you enter a 0, no time is allowed for you to 
enter characters, and all characters are read from the 
type-ahead buffer. 


If you need more than 255(decimal) intervals, issue an 
asynchronous QIOS request followed by a Mark Time directive 
(MRKTS$) for the required interval. Specify different event 
flags in the two directives and, after issuing them, wait 
for the Logical OR of the two event flags. 


Send XOFF - The driver sends an XOFF to the terminal after 
its prompt~and-read. The XOFF (CTRL/S) may have the effect 
of inhibiting input from the terminal, if the terminal 
recognizes xXOFF for this purpose. TEF.XOF is ignored when 
full-duplex I/O is in use. 
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2.4.10 QIO$C IO.RST - Read Logical Block with Special Terminators 


Issue IO.RST to read a block of data from the specified physical 
device unit. This function is equivalent to an I0O.RLB!ITF.RST. 
Certain special characters in the ranges 0-037 and 175-177 terminate 
the read. The driver does not interpret the terminating character. 
For example, a DELETE or RUBOUT (177) does not erase, and a CTRL/C 
does not produce a CLI prompt, or, if CTRL/C is enabled, abort tasks 
active at the terminal. Also CTRL/U and CTRL/R do not perform their 
usual functions. All control characters are terminators. 


TF.RST sets TF.TNE by default, which means that terminators are not 
echoed on the terminal screen. 


If uppercase to lowercase conversion is disabled, characters 175 and 
176 do not act as terminators. CTRL/O, CTRL/Q, and CTRL/S (017, 021, 
and 023, respectively) are not special terminators. The driver 
interprets them as output control characters in a normal manner. 


Upon successful completion of an I0O.RST request that was not 
terminated by filling the input buffer, the first word of the I/0 
status block contains the terminating character in the high byte and 
the IS.SUC status code in the low byte. The second word contains the 
number of bytes contained in a buffer. The terminating character is 
not put in the buffer. 


The format of QIOSC IO.RST is as follows: 


QIOSC IO.RST| !TF.RAL |,lun,] efn | ,<stadd,size,[tmo]> 


ITF .RNE ,| pri 
ITF.TMO ,| isb 
!TF.XOF 7} ast 


Parameters: 
The parameters have the following meanings: 
Parameter Meaning 


lun The logical unit number of the associated physical device 
unit to be accessed by the I/0 request. For more 
information refer to Chapter l. 


efn The number of the event flag to be associated with the QIO$ 
operation. For more information refer to Chapter l. 


pri Makes this QIOS macro compatible with RSX-11D. Use a_ value 
of 0 or a null for this parameter. 


isb The address of the I/O status block (I/O status double-word) 
associated with the I/O request. For more information refer 
to Chapter l. 


ast If you want to interrupt your task to execute special code 
upon completion of this I/O request, you may specify ast. 
When this I/O request completes, control branches to the 
address specified by ast at the software priority of the 
requesting task. Omit ast or specify 0 to omit AST 
processing. 
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Parameter Meaning 


stadd The starting address of the data buffer. Stadd may be on a 
byte boundary. 


size The size of the stadd data buffer in bytes. The specified 
size must be greater than 0 and less than or equal to 8128 
bytes. The buffer must be within the task's address space. 


tmo The optional time-out count for use with the TF.TMO 
subfunction. 


Subfunction Bits: 


The subfunctions have the following meanings: 


Subfunction Meaning 
TF .RAL Read All Characters (Pass All) - The driver passes all 
characters to the requesting task. The characteristic 


TC.8BC, when set, allows the driver to pass eight bits. For 
example, CTRL/C, CTRL/Q, CTRL/S, CTRL/O, and CTRL/Z are 
passed to the task and not interpreted by the driver. 


’ 
Exercise great care when using TF.RAL (read all) and TEF.RST 
(read with special terminators) together. Obscure problems 
can result if you use them in this way. 


TF.RNE Read With No Echo — Reads terminal input characters without 
echoing the characters back to the terminal for immediate 
display. You can use this feature when typing sensitive 
information. CTRL/R is ignored while Read With No Echo is 
in progress. 


TF.TMO Read With Time-Out - This subfunction allows the use of the 
tmo parameter to require input from the terminal within a 
specified time. 


Specify the time-out count in 10-second intervals. Time-out 
is the maximum time allowed between two input characters 
before the read is aborted. The maximum time-out value is 
255(decimal) intervals. 


If 0 is specified, the read times out immediately after 
reading any data that may be in the type-ahead buffer. In 
other words, if you enter a 0, no time is allowed for you to 
enter characters, and all characters are read from the 
type-ahead buffer. 


If you need more than 255(decimal) intervals, issue an 
asynchronous QIOS request followed by a Mark Time directive 
(MRKTS) for the required interval. Specify different event 
flags in the two directives and, after issuing them, wait 
for the Logical OR of the two event flags. 


TF .XOF Send XOFF - The driver sends an XOFF to the terminal after 
its read. The XOFF (CTRL/S) may have the effect of 
inhibiting input from the terminal, if the terminal 


recognizes xXOFF for this purpose. TF.XOF is ignored when 
full-duplex I/O is in use. 
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2.4.11 QIO$ IO.RTT - Read with Terminator Table 


The IO.RTT function reads characters in a manner like the I0.RLB 
function, except that a character that you have specified previously 
terminates the read operation. The specified character's code can 
range from 0 through 377 (octal). You can specify it by setting a bit 
in a 16-word table that corresponds to the desired character. 
Multiple characters can be specified by setting their corresponding 
value. 


The l6-word table starts at the address specified by the table 
parameter. The first word contains bits that represent the first 16 
ASCII character codes (0-17); similarly, the second word contains bits 
that represent the next 16 character codes (20-37), and so forth, 
through the sixteenth word, bit 15, which represents character code 
ST Ts For example, to specify the % symbol (code 045) as a read 
terminator character, set bit 05 in the third word, because the third 
word of the table contains bits representing character codes 40-57. 


If you use the IO.EIO!TF.RLB function, the modifier TF.RTT allows you 
to specify the length of the table from 1 to 32(decimal) bytes. 


If you want to use the CTRL/S (023), CTRL/Q (021), or any characters 
greater than 177 as the terminator characters, the terminal must be 
set to allow a read-pass-all operation (TC.BIN=1l), or read-pass eight 
bits (TC.8BC), as listed in Table 2-4. 

The optional timeout count parameter may be included as desired. 


The format of QIOSC IO.RTT is as follows: 


QIOSC IO.RTT | !TF.RAL | ,lun, | efn | ,<stadd,size,[tmo] ,table> 


!TF.RCU ,| pri 
ITE .RNE , isb 
!TF.TMO ,| ast 


Parameters: 


The parameters have the following meanings: 


Parameter Meaning 
lun The logical unit number of the associated physical device 
unit to be accessed by the I/0 request. For more 


information refer to Chapter l. 


efn The number of the event flag to be associated with the QIOS 
operation. For more information refer to Chapter l. 


pri Makes this QIOS macro compatible with RSX-11D. Use a_ value 
of 0 or a null for this parameter. 


isb The address of the I/O status block (I/O status double-word) 


associated with the I/O request. For more information refer 
to Chapter l. 


ast If you want to interrupt your task to execute special code 
upon completion of this I/O request, you may specify ast. 


When this I/O request completes, control branches to the 
address specified by ast at the software priority of the 
requesting task. Omit ast or specify 0O to omit AST 
processing. 


Parameter 


stadd 


size 


tmo 


table 
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Meaning 


The starting address of the data buffer. Stadd may be on a 
byte boundary. 


The size of the stadd data buffer in bytes. The specified 
size must be greater than 0 and less than or equal to 8128 
bytes. The buffer must be within the task's address space. 


The optional time-out count for use with the TF.TMO 
subfunction. 


The address of the 16-word special terminator table that you 
create in your task. 


Subfunction Bits: 


The subfunctions have the following meanings: 


Subfunction Meaning 


TF.RAL 


TF.RCU 


TF.RNE 


TF.TMO 


Read All Characters (Pass All) - The driver passes all 
characters to the requesting task. The characteristic 
TC.8BC, when set, allows the driver to pass eight bits. For 
example, CTRL/C, CTRL/Q, CTRL/S, CTRL/O, and CTRL/Z are 
passed to the task and not interpreted by the driver. 


Exercise great care when using TF.RAL (read all) and TF.RST 
(read with special terminators) together. Obscure problems 
can result if you use them in this way. 


Restore Cursor Position - When defining cursor position in a 
function, you can use the TF.RCU subfunction to save the 
current cursor position. When included in this manner, 
TFE.RCU causes the driver to first save the current cursor 
position, then position the cursor and output the specified 
buffer, and, finally, restore the cursor to the original 
(saved) position once the output transfer has been 
completed. 


Read With No Echo - Reads terminal input characters without 
echoing the characters back to the terminal for immediate 
display. You can use this feature when typing sensitive 
information. CTRL/R is ignored while Read With No Echo is 
in progress. 


Read With Time-Out - This subfunction allows the use of the 
tmo parameter to require input from the terminal within a 
specified time. 


Specify the time-out count in 10-second intervals. Time-out 
is the maximum time allowed between two input characters 
before the read is aborted. The maximum time-out value is 
255(decimal) intervals. 


If 0 is specified, the read times out immediately after 
reading any data that may be in the type-ahead buffer. In 
other words, if you enter a 0, no time is allowed for you to 
enter characters, and all characters are read from the 
type-ahead buffer. 


If you need more than 255(decimal) intervals, issue an 
asynchronous QI0O$ request followed by a Mark Time directive 
(MRKTS) for the required interval. Specify different event 
flags in the two directives and, after issuing them, wait 
for the Logical OR of the two event flags. 
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2.4.12 QIOSC IO.WAL - Write a Logical Block and Pass all Bits 

The QIOSC IO.WAL macro causes the driver to pass all output from the 
buffer without interpretation. It does not intercept control 
characters. Long lines are not wrapped around if input/output 
wraparound has been selected. 

IO.WAL is equivalent to the IO.WLB!TF.WAL function. 

The format of the QIOSC IO.WAL macro is as follows: 


QIOSC IO.WAL | !TE.CCO | ,lun, | efn | ,<stadd,size,vfc> 


!TF.RCU ,| pri 
{TF .WBT F isb 
, | ast 


Parameters: 
The parameters have the following meanings: 
Parameter Meaning 


lun The logical unit number of the associated physic device unit 
to be accessed by the I/O request. For more information 
refer to Chapter l. ° 


efn The number of the event flag to be associated with the QIOS 
operation. For more information refer to Chapter l. 


pri Makes this QIOS macro compatible with RSX-11D. Use a_ value 
of 0 or a null for this parameter. 


isb The address of the I/O status block (I/O status double-word) 
associated with the I/O request. For more information refer 
to Chapter 1. 


ast If you want to interrupt your task to execute special code 
upon completion of this I/O request, you may specify ast. 
When this I/O request completes, control branches to the 
address specified by ast at the software priority of the 
requesting task. Omit ast or specify 0O to omit AST 
processing. 


stadd The starting address of the data buffer. Stadd may be on a 
byte boundary. 


size The size of the stadd data buffer in bytes. The specified 
size must be greater than 0 and less than or equal to 8128 
bytes. The buffer must be within the task's address space. 


Parameter 


vfc 
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Meaning 


The terminal driver responds to task I/O requests for cursor 
positioning without the task requiring information about the 
type of terminal in use. 


The vfc parameter specifies cursor position. The parameter 
is interpreted as a vfc parameter if the high byte of the 
parameter is 0. However, if the parameter defines cursor 
position, the high byte must be nonzero, the low byte is 
interpreted as column number (x-coordinate), and the high 
byte is interpreted as line number (y-coordinate). Home 
position, the upper left corner of the display, is defined 
as. l,ls The driver outputs cursor-positioning commands 
appropriate for the terminal in use that move the cursor to 
the specified position. If the most significant bit of the 
line number is set, the driver clears the display before 
positioning the cursor. 


Table 2-9 is a summary of all characters that your task can 
use for vertical format control on the terminal. Any one of 
these characters can be specified as the value of the vfc 
parameter. 


Subfunction Bits: 


The subfunctions have the following meanings: 


Subfunction Meaning 


TF .CCO 


TF.RCU 


Cancel CTRL/O - Writes a logical block of data to the 
terminal regardless of a CTRL/O condition that may be in 
effect. The CTRL/O, if in effect, is canceled before the 
write occurs. 


During a write-pass-all operation, the terminal driver 
outputs characters without interpretation; it does not keep 
track of cursor position. 


Restore Cursor Position - When defining cursor position ina 
function, you can use the TF.RCU subfunction to save the 
current cursor position. When included in this manner, 
TF.RCU causes the driver to first save the current cursor 
position, then position the cursor and output the specified 
buffer, and, finally, restore the cursor to the original 
(saved) position once the output transfer has been 
completed. 


During a write-pass-all operation (IO.WAL or IO.WLB!TF.WAL), 
the terminal driver outputs characters without 
interpretation; it does not keep track of cursor position. 
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Subfunction Meaning 


TE .WBT 


Write Breakthrough - Instructs the driver to write the 
buffer regardless of the I/0 status of the receiving 
terminal. If another write function is currently in 
progress, it finishes the current request and the write 
breakthrough is the next write issued. Therefore, the 
TF .WBT subfunction cannot break through another write 
breakthrough that is in progress. The effect of this is 
that a CTRL/S can stop write breakthrough functions. fThus, 
it may be desirable for tasks to time out on breakthrough 
write operations. 


If a read is currently posted, the write breakthrough 
proceeds, and an automatic CTRL/R is performed to redisplay 
any input that was received before the breakthrough write 
was effected (if the terminal is not in the full-duplex 
mode). 


CTRL/O, if in effect, is canceled. 
An escape sequence that was interrupted is rubbed out. 


Break-through write may be issued by a privileged task only. 
(The DCL command BRO (broadcast) uses IO.WBT.) 


During a write-pass-all operation, (IO.WAL or IO.WLB!TF.WAL) 
the terminal driver outputs characters without 
interpretation; it does not keep track of cursor position. 
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2.4.13 QIOS$C IO.WBT - Break Through to Write a Logical Block 


The QIOSC IO.WBT macro instructs the driver to write the buffer 
regardless of the I/O status of the receiving terminal. If an IO.WBT 
function is issued on a system that does not support I0O.WBT, it is 
treated as an IO.WLB function. 


e If another write function is currently in progress, it 
finishes the current request and the IO.WBT is the next write 
issued. The effect of this is that a CTRL/S can stop I0.WBT 


functions. Therefore, it may be desirable for tasks to time 
out on IO.WBT operations. 


e If a read is currently posted, the IO.WBT proceeds, and an 
automatic CTRL/R is performed to redisplay any input that was 
received before the breakthrough write was effected (if the 
terminal is not in the full-duplex mode). 

e If CTRL/O is in effect, it is canceled. 


e An escape sequence that was interrupted is rubbed out. 


An IO.WBT function cannot break through another I0.WBT that is in 
progress. 


Breakthrough write may be issued by a privileged task only. 
The format of the QIOSC IO.WBT macro is as follows: 


QIOSC IO.WBT | !TF.CCO }|,lun, | efn | ,<stadd,size,vfc> 


!TF.RCU ,| pri 
ITF WAL , | isb 
,{ ast 


Parameters: 


The parameters have the following meanings: 


Parameter Meaning 
lun The logical unit number of the associated physical device 
unit to be accessed by the I/0 request. For more 


information refer to Chapter l. 


efn The number of the event flag to be associated with the QI0$ 
operation. For more information refer to Chapter l. 


pri Makes this QIOS macro compatible with RSX-11D. Use a_ value 
of 0 or a null for this parameter. 


isb The address of the I/O status block (I/O status double-word) 
associated with the I/O request. For more information refer 
to Chapter l. 


ast If you want to interrupt your task to execute special code 
upon completion of this I/O request, you may specify ast. 
When this I/O request completes, control branches to the 
address specified by ast at the software priority of the 
requesting task. Omit ast or specify 0 to omit AST 
processing. 


stadd The starting address of the data buffer. Stadd may be on a 
byte boundary. 


Parameter 


size 


vfc 
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Meaning 


The size of the stadd data buffer in bytes. The specified 
size must be greater than 0 and less than or equal to 8128 
bytes. The buffer must be within the task's address space. 


The terminal driver responds to task I/O requests for cursor 
positioning without the task requiring information about the 
type of terminal in use. 


The vfc parameter specifies cursor position. The parameter 
is interpreted as a vfc parameter if the high byte of the 
parameter is 0. However, if the parameter defines cursor 
position, the high byte must be nonzero, the low byte is 
interpreted as column number (x-coordinate), and the high 
byte is interpreted as line number (y-coordinate). Home 
position, the upper left corner of the display, is defined 
as 1,l. The driver outputs cursor-positioning commands 
appropriate for the terminal in use that move the cursor. to 
the specified position. If the most significant bit of the 
line number is set, the driver clears the display before 
positioning the cursor. 


Table 2-9 is a summary of all characters that your task can 
use for vertical format control on the terminal. Any one of 
these characters can be specified as the value of the vfc 
parameter. 


Subfunction Bits: 


The subfunctions have the following meanings: 


Subfunction Meaning 


TF .CCO 


TF.RCU 


TF.WAL 


Cancel CTRL/O - The driver writes a logical block of data to 
the terminal regardless of a CTRL/O condition that may be in 
effect. The CTRL/O, if in effect, is canceled before the 
write occurs. The IO.WBT function implies the subfunction 
TF.CCO, therefore using IO.WBT!ITF.CCO is redundant. 


Restore Cursor Position - When defining cursor position ina 
function, you can use the TF.RCU subfunction to save the 
current cursor position. When included in this’ manner, 
TF.RCU causes the driver to first save the current cursor 
position, then position the cursor and output the specified 
buffer, and, finally, restore the cursor to the original 
(saved) position once the output transfer has been 
completed. 


Write All Bits - During a write-pass-all operation (IO.WAL 
or IO.WLBITF.WAL), the terminal driver outputs characters 
without interpretation -- it does not intercept control 
characters and it does not keep track of cursor position. 
Long lines are not wrapped around if input/output 
wrap-around has been selected. 
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2.4.14 QIOSC SF.GMC - Get Multiple Characteristics 


The SF.GMC QIOS$ macro returns terminal characteristics information 
into a specified buffer. Table 2-4 in this section shows the terminal 
characteristics that can be obtained with this QIOS macro. 


The format of the QIOSC SF.GMC macro is as follows: 


Q{tOSC SF.GMC,lun,[efn],[pri],[isb],[ast] ,<stadd,size> 


Parameters: 


The parameters have the following meanings: 


Parame cer 


lun 


efn 


pri 


isb 


ast 


stadd 


size 


Meaning 


The logical unit number of the associated physical device 
unit to be accessed by the I/0 request. For more 
information refer to Chapter l. 


The number of the event flag to be associated with the QIOS 
operation. For more information refer to Chapter l. 


Makes this QIOS macro compatible with RSX-11D. Use a value 
of 0 or a null for this parameter. 


The address of the I/O status block (I/O status double-word) 
associated with the I/O request. For more information refer 
to Chapter 1, but consider the following exception. 


For SF.GMC, the contents of the I/O Status Block (ISB) is 
different from that described in Chapter 1. The first word 
of the status block is the same as that in Chapter 1. 
However, the second word is not the same. For SF.GMC or 
SF.SMC the second word contains the number of bytes in the 
specified user buffer that were sucessfully processed. For 
example, if you have a characteristic in the buffer that 
caused an error, ISBt+2 (the second word) will contain the 
offset to the characteristic. 


If you want to interrupt your task to execute special code 
upon completion of this I/O request, you may specify ast. 
When this I/O request completes, control branches to the 
address specified by ast at the software priority of the 
requesting task. Omit ast or specify 0 to omit AST 
processing. 


The starting address of a data buffer of length "size" 
bytes. Each word in the buffer has the form 


-BYTE characteristic-name 
-BYTE 0O 


characteristic-—name 


One of the bit names given in Table 2-5. The value 
returned in the high byte of each byte-pair is 1 if the 
characteristic is true for the terminal and 0 if it is 
not true. 


The size of the stadd data buffer in bytes. The specified 
size must be greater than 0 and less than or equal to 8128 
bytes. The buffer must be within the task's address’ space. 
For SF.GMC, size must be an even value. 
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For the TC.TTP characteristic (terminal type), one of the values shown 
in Table 2-5 is returned in the high byte. 


Table 2-4 
Terminal Characteristics 
for SF.GMC and SF.SMC Functions 


Bit Octal Corresponding 
Name Value Meaning (if asserted) DCL Command 
TC.ABD 77 Auto-baud detection SET TERM/AUTOBAUD 
TC.ACD --- Ancillary control driver. -- 
Value determined by system 
Manager. 
TC.ACR 24 Wrap-around mode SET TERM/WRAP 
TC.ANI 122 ANSI CRT terminal SET TERM/ANSI_ CRT 
TC.ASP 76 Remote line answer speed. SET TERM/REMOTE/SPEED:brate 


Initial speed over 
dial-up line. 


TC.AVO 123 VT100-family terminal SET TERM/ADVANCED VIDEO 
display 
TC.BIN 65 Binary input mode SET TERM/PASSALL 


(read-pass-all). No 
characters are interpreted 
as control characters. 


TC.BLK 42 Terminal is capable of SET TERM/BLOCK MODE 
block mode transfers 


TC.CTS 72 Suspend output to terminal. -- 
Task can cancel an input 
“S or get the current 
state of the terminal 
with regard to “S or 
nO, 
0 
1 


resume 
suspend 


TC.DEC 124 Digital CRT terminal SET TERM/DEC_ CRT 
Tc. piu! 41 Dial-up line SET TERM/REMOTE 


TC.EDT 125 Terminal performs editing SET TERM/EDIT MODE 
functions 


1. A program can enable the auto-call feature of the DFO3 modem 
by setting TC.DLU to a value of two. Auto-call allows you to use 
the terminal to dial out of the computer. (This is in addition 
to receiving incoming calls.) While in this mode, read and write 
requests are serviced even when a line is not in use. 
Consequently, I/0 requests do not fail when the line is hung-up, 
which is the case for remote lines (TC.DLU=1). 


(continued on next page) 
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Table 2-4 (Cont.) 
Terminal Characteristics 
for SF.GMC and SF.SMC Functions 


Bit Octal Corresponding 
Name Value Meaning (if asserted) DCL Command 
TC.EPA 40 When TC.PAR is enabled: SET TERM/PARITY:value 
0 = odd parity 
1 = even parity 
TC. ESQ 35 Input escape sequence SET TERM/ESCAPE 
recognition 
TC. FDX 64 Full-duplex mode SET TERM/FULL DUPLEX 
TC. AFF 17 Hardware form-feed SET TERM/FORM FEED 


capability (If 0, 
form-feeds are simulated 
using TC.LPP.) 


TC.HFL 13 Number of fill characters SET TERM/CRFILL 
to insert after a carriage 
return (0-7=x) (Use a value 
of 7 for the LA30-S.) 


TC.HHT 21 Horizontal tab capability SET TERM/TAB 


(if 0, horizontal tabs are 
simulated using spaces.) 


TC.HLD 44 Hold screen mode. SET TERM/HOLD SCREEN 
Terminal has ability 
to hold screen. Not 
supported over net (NCT). 


TC.HSY 137 Host to terminal SET TERM/HOST SYNC 
synchronization. XOFF 
sent when resources are 
low. XON sent when 
resources are high. XOFF 
prevents terminal character 
input. 
0 = No flow control 
1 Flow control exerted 


TC.1CS 141 Notify of change in 
type-ahead buffer 
(input count state) 


TC. ISL 6 Get MUX subline (=0-15) -- 
on interface to which user is 
connected (SF.GMC only). 


(continued on next page) 


Bit 
Name 


TC. LPP 


TC.MHU 


TC.NBR 


TC .NEC 


TC.OOB 


TC. PAR 
TC. PPT 


TC. PRI 


TC. PTH 


TC.RAT 


TC.RGS 


TC.RSP 


TC.SCP 


TC.SFC 


TC.SLV 


47 


140 


a7 
147 


51 


146 


126 
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Table 2-4 (Cont.) 


Terminal Characteristics 
for SF.GMC and SF.SMC Functions 


Corresponding 
Meaning (if asserted) 


Page length (1-255.=x) 


Declare modem hangup AST. 
Specify address of AST 
activated by lost carrier. 


Broadcast disabled 
Echo suppressed 


Specify out-of-band 
characters, whether 

they are included in the 
type-ahead buffer, and 
if they are to clear the 
type-ahead buffer. 


Generate and check parity 
Terminal has printer port 


Terminal is privileged 
(SF.GMC only) 


Pass through enable 

Only CTRL/S and CTRL/Q are 

honored. 

1 = pass through 

0 = default; no pass 
through 


Type-ahead buffer: 

0 = l-character type-ahead 
1 = 36-character type-ahead 
(RSX-11M only) 


Terminal supports REGIS 
instructions 


Receiver speed 
(bits-per-second) 


Terminal is a scope (CRT) 


Terminal supports soft 
character set 


No unsolicited input 
is accepted 


DCL Command 
SET TERM/PAGE LENGTH:n 


SET TERM/NOBROADCAST 


SET TERM/NOECHO 


SET TERM/PARITY: value 
SET TERM/PRINTER_ PORT 


SET TERM/PRIVILEGED 


SET TERM/PASSTHRU 


SET /TYPEAHEAD=TTnn: 


SET TERM/REGIS 
SET TERM/SPEED=: (xmit,rcv) 


SET TERM/SCOPE 


SET TERM/SOFT CHARACTERS 


SET TERM/SLAVE 


(continued on next page) 
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Table 2-4 (Cont.) 
Terminal Characteristics 
for SF.GMC and SF.SMC Functions 


Bit 
Name 


TC.SMR 


TC.SSC 


TC.TBF 


TC.TBM 


TC.TBS 


TC.TLC 


TC.TMM 


TC.TSY 


TC.TTP 


TC. VFL 


Octal 
Value 


25 


142 


ol 


101 


100 


130 


143 


144 


10 


14 


Corresponding 
Meaning (if asserted) DCL Command 
Upper-case conversion SET TERM/UPPERCASE 
disabled 


Specify terminal management -- 
switch characters. These 

cause a Switch from normal 

mode to terminal management 

mode. 


Type-ahead buffer count -- 
obtained by SF.GMC. 
Cleared by SF.SMC. 


Type-ahead buffer mode SET TERM/SERIAL 
O=task type-ahead 
1=CLI type-ahead 


Type-ahead buffer size SET TERM/TYPEAHEAD:n 
(0-255=x) (RSX-11M-PLUS 
I/D systems only) 


CLI gets CTRL/C notification SET TERM/CONTROL= 


In terminal management mode. -- 
Set when switch characters 

have been detected and 

terminal management mode is 

active. Cleared by QIOS 


SF.SMC. 
1 = In terminal management 
mode 
0 = Exit terminal management 
mode 
Output flow control SET TERM/TTSYNC 


Allows input XON or XOFF 
to function. XOFF prevents 
output from the terminal. 
0 = XON/XOFF ignored 

1 = default; process 


XON /XOFF 
Terminal type (=0-255.=x) SET TERM/type 
Send four fill characters SET TERM/LFILL=TTnn: 


after line feed for vetical 
forms control. 
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Table 2-4 (Cont.) 
Terminal Characteristics 
for SF.GMC and SF.SMC Functions 


Bit Octal Corresponding 

Name Value Meaning (if asserted) DCL Command 

TC.WID 2 1 Page width (=1-255.=x) SET TERM/WIDTH:n 

TC.XSP 4 Transmitter speed SET TERM/SPEED: (xmit,rcv) 


(bits-per-second) 


TC. &BC 67 Pass eight bits on input, SET TERM/EIGHTBIT 
even if not binary input 
mode (TC.BIN). 


2. Unsolicited input that fills the buffer before a terminator 
is received is possibly invalid. When this happens, the driver 
discards the input by simulating a CTRL/U and echoing “U. 


In Table 2-5, the octal values 0-177 are reserved by DIGITAL. Values 
200-377 are available for customer use to define non-DIGITAL 
terminals. The implicit characteristics shown are set by the driver. 
Values not shown are not automatically set by the driver. An 
"unknown" terminal type has no implicit characteristics. 


Table 2-5 
Bit TC.TTP (Terminal Type) Values 
Set by SF.SMC and Returned by SF.GMC 


Implicit Characteristics 


Octal Terminal 

Value Symbol Type TC.LPP TC.WID TC.HFF TC.HHT TC.HFL TC.VFL TC.SCP 
0 t.UNKO Unknown 
15 ¢.V100 VT100 24 80 1 
16 ~.L120 LA120 66 132 1 1 
20 ’.LA12 LA12 66 132 1 1 
21 T.L100 LA100 66 132 1 1 
22 T.LA34 LA34 66 132 1 
23 T.LA38 LA38 66 132 1 
24  .V101 vT101 24 80 1 1 
25 T.V102 VT102 24 80 1 1 
26 T.V105 VT105 24 80 1 1 
27 T.V125 VT125 24 80 1 1 
30 T.V131 VT131 24 80 fil: 1 
31 T,.V132 VT132 24 80 1 1 
32 T.LA50 LA50 66 80 1 1 
34 T.LOQP2 LQPO2 66 132 1 1 
35 T.V2XX VT 2XX 24 80 
37 T.LNO3 LNO3 66 132 1 1 
40 T.DTC1 DTCO1 66 132 
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2.4.14.1 Characteristic Bit Special Information - The following bits 
have special, additional information: 


TC.RSP, TC.XSP, TC.ASP - The DCL SET TERM/SPEED command 
requires parameters for both receiver (rcv) and transmitter 
(xmit) baud rates. (The valid combinations for each are in 
the RSX-11M/M-PLUS Command Language Manual.) The DCL SET 
TERM/SPEED command format is as follows: 


SET TERM/SPEED: (xmit,rcv) 


The list of baud rates in bps and valid DCL SET TERM/SPEED or 
SET TERM/REMOTE values that may be set is as follows: 


TC.ASP 

TC.RSP or 

TC.XSP Baud Rate (in bps) And Valid DCL SET Values 

Value 

S.0 (disabled) 

S.50 50 (Baudot codes are not 

- supported) 

S.75 75 

S.110 110 

S.134 134 

S.150 150 

S.200 200 

S.300 300 

S.600 600 

S.1200 1200 

S.1800 1800 

S.2000 2000 

S.2400 2400 

S.3600 3600 (Not available on DHV11 
multiplexer.) 

S.4800 4800 

S.7200 7200 (Not available on DHV11 
multiplexer.) 

S.9600 9600 

$.19.2 19200 (Not available on DZV11 or 

DZQ11 


multiplexer.) 


DZV11l and DZQ1l transmitter and receiver speeds must be equal 
(no split baud rates permitted). Only one value may be 
specified for the remote answer speed. This value applies to 
both the transmitter and receiver. 


TC.TTP - When the terminal driver reads this bit, the driver 
sets implicit values for terminal characteristics TC.LPP, 
TC.WID, TC.HFF, TC.HHT, TC.VFL, and TC.SCP as shown in Table 
2-4. You can change (override) these values by subsequent Set 
Multiple Characteristics requests. In addition, the terminal 
driver uses TC.TTP to determine cursor positioning commands, 
as appropriate. 
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TC.CTS - Returns the current suspend (CTRL/S) , resume 
(CTRL/Q), or suppress (CTRL/O) state set via the SF.SMC 
function. Values returned are as follows: 


Value 
Returned State 
0 Resume (CTRL/Q) 
1 Suspend (CTRL/S) 
2 Suppress (CTRL/O) 
3 Both suppress and suspend 


When a value of 0 is used with the SF.SMC function, the 
Suspend state is cleared; a value of 1 selects the suspend 
state. 


TC.TBF -— Returns the number of unprocessed characters in the 
type-ahead buffer for the specified terminal. This allows 
tasks to determine if any characters were typed that did not 
require AST processing. In addition, you can use the value 
returned to read the exact number of characters typed, rather 
than a typical value of 80. or 132. characters for the 
terminal. Please note the following three items when 
attempting to use the number returned by TC.TBF: 


1. The task must attach (QIO$ IO.ATT) the terminal to receive 
characters from the type-ahead buffer. 


2. The maximum capacity of the type-ahead buffer is 
255 (decimal) characters. 


3. Using TC.TBF in an SF.SMC function flushes the type-ahead 
buffer. 
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2.4.15 QIOSC SF.SMC - Set Multiple Characteristics 


The Q10SC SF.SMC macro enables a task to set and reset the 
characteristics of a terminal. SF.SMC is the inverse function of 
SF.GMC (Get Multiple Characteristics). 


Table 2-4 notes the restrictions that apply to these characteristics. 


If the characteristic-name is TC.TTP (terminal type), value can have 
any of the values listed in Table 2-5. 


A nonprivileged task can issue an SF.SMC request for its own terminal 
(TI:) only. A privileged task can issue SF.SMC to any terminal. 


Terminal output can be suspended or resumed (simulated CTRL/S_ and 
CTRL/Q, respectively) by specifying an appropriate value for TC.CTS. 
A value of 0 resumes output and a value of 1 suspends’ output. 
Specifying any value for TC.TBF flushes (clears) the type-ahead buffer 
(forces the type-ahead buffer count to 0). 


Before a remote line is answered the driver clears certain terminal 
characteristics that may have been set by an SF.SMC function. 


For SF.SMC, the contents of the I/O Status Block (ISB) is different 
from that described in Chapter 1. The first word of the status block 
is the same as that in Chapter 1. However, the second word is not the 
same. For SF.GMC or SF.SMC the second word contains the number of 
bytes in the specified user buffer that were successfully processed. 
For example, if you have a characteristic in the buffer that caused an 
error, ISB+t+2 (the second word) will contain the offset to the 
characteristic. 


The format of QIOSC SF.SMC is as follows: 
Q10Sc SF.SMC,1lun,[efn],[pri],[isb],[{ast],<stadd,size> 
Parameters: 


The parameters have the following meanings: 


Parameter Meaning 
lun The logical unit number of the associated physical device 
unit to be accessed by the I/0 request. For more 


information refer to Chapter l. 


efn The number of the event flag to be associated with the QIOS 
operation. For more information refer to Chapter l. 


pri Makes this QIOS macro compatible with RSX-11D. Use a_ value 
of 0 or a null for this parameter. 


isb The address of the I/O status block (I/O status double-word) 
associated with the I/O request. For more information refer 
to Chapter 1; however, the I/O status block used for SF.SMC 
is different than that described in Chapter l. 


ast If you want to interrupt your task to execute special code 
upon completion of this I/O request, you may specify ast. 
When this I/O request completes, control branches to the 
address specified by ast at the software priority of the 
requesting task. Omit ast or specify 0 to omit AST 
processing. 
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Parameter Meaning 


stadd The starting address of a buffer of length "size" bytes. 
The address must be word aligned for SF.SMC. Except for the 
characteristics TC.MHU, TC.SSC, and TC.OOB, each word in the 
buffer has the form 


-BYTE characteristic-name 
e-BYTE value 


characteristic—name 
One of the symbolic bit names given in Table 2-4. 
value 


Either 0 (to clear a given characteristic) or 1 (to set 
a characteristic). 


size The size of the stadd data buffer in bytes. The specified 
size must be greater than 0 and less than or equal to 8128 
bytes. The buffer must be within the task's address space. 
For SF.SMC, size must be an even value. 


2.4.15.1 Characteristic Processing for TC.MHU, TC.SSC, and TC.OOB - 
Three characteristics require special processing and buffers. These 
characteristics are TC.MHU, TC.SSC, and TC.OOB. The buffers have’ the 
form 


-BYTE characteristic name 
-BYTE reserved 
»~WORD eee? 
The processing for the four characteristics is described following: 
Characteristic Processing 
TC.MHU This characteristic declares a modem hangup AST. The buffer 
required for TC.MHU is shown in Figure 2-3. The buffer must 
contain the address of an AST that is activated when the 
terminal driver detects that the carrier has been lost. A 
zero in word 2 (AST address) clears this characteristic. 


The buffer has the following form: 


AST address or 0 


ZK-4081-85 


Figure 2-3 Buffer Required for TC.MHU 
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Characteristic Processing 


TC.SSC 


TC.OOB 


The characteristic TC.SSC defines and redefines terminal 
Switch characters. The buffer required for TC.SSC is shown 
in Figure 2-4. Switch characters can be disabled while the 
terminal is in terminal management mode. The terminal must 
be attached (IO.ATT) before you set this characteristic. 
However, the terminal must not be attached for notification 
of unsolicited input ASTs (IO.ATA). 


The buffer has the following format: 


AST address or 0 


ZK-4082-85 


Figure 2-4 Buffer Required for TC.SSC 


When the AST address is zero, the switch characters are 
disabled. 


If the terminal is in terminal management mode, both CTRL/C 
and switch characters are treated as normal data. If the 
terminal is not currently in terminal management mode _ and 
switch characters have been enabled, the terminal driver 
compares the input characters against the specified switch 
characters. If there is a match, it cancels any pending 
read with a status of IS.TMM, flushes the type-ahead buffer, 
executes the specified AST, and sets the terminal in 
terminal management mode. 


The characteristic TC.OOB defines the out-of-band (0OOB) 


character set for the particular terminal. The buffer 
required for TC.OOB is shown in Figure 2-5. The terminal 
must be attached (IO.ATT) before you set this 


characteristic. However, the terminal must not be attached 
for notification of unsolicited input ASTs (IO.ATA). 


The buffer has the following format: 


Octal Decimal 


ZK-4084-85 


Figure 2-5 Buffer Required for TC.OOB 


2-56 
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- Because all OOBs are either HELLO or CLEAR, one set of 
bit masks may be used for both. A zero bit mask is a 
CLEAR. A one bit mask is a HELLO. 


- Characters that are CLEAR OOB cannot also be used ‘for 
INCLUDE OOB. 


- To add a character to the OOB set, all the characters 
must be defined not only the one. 


2.4.15.2 Side Effects of Setting Characteristics - Certain terminal 
characteristics that a task may set or that an operator may set using 
DCL commands may have undesirable side effects. In particular, these 
characteristics include the hold-screen mode and the lowercase to 
uppercase conversion disable mode. Their effects are described 
following: 


TC.HLD Unexpected behavior can result from a terminal in the 
hold-screen mode if its reception rate is much greater than 
its transmission rate. ‘(The DHV11 supports split baud 


rates.) When in the hold-screen mode, the terminal 
automatically sends a CTRL/S during reception of an _ output 
stream when the screen is nearly full. Output is 
resumed -- another screenfull -- when you type SHIFT/SCROLL 


(the terminal generates CTRL/Q). Thus, no output is lost as 
a result of scrolling off the screen before you can read it. 
However, if the terminal's transmission rate is far below 
its reception rate, some unread output may scroll out of 
sight before the CTRL/S can be transmitted. 


Note that some terminals and interfaces are hardware 
buffered. This can cause obscure timing problems for tasks 
that attempt to invoke the hold-screen mode. 


TC.SMR If this characteristic is asserted (lowercase to uppercase 
conversion is disabled), octal characters 175 and 176 are 
interpreted as “right brace (})" and "tilde (~)," 
respectively. If TC.SMR is not asserted, these characters 
are interpreted as an ALTmode (that is, they function as 
line terminators that do not advance the cursor to a new 
line). 


TC.SSC Setting switch characters disables the normal function of 
CTRL/C in that it becomes a normal data character. After 
typing switch characters and entering terminal management 
mode, switch characters are normal data characters until the 
terminal driver exits terminal management mode. 


After you have entered the first character, terminal driver 
must wait for the second one before entering terminal 
management mode. If the second character is not the second 
switch character, the terminal driver treats both entered 
characters as normal data characters. Any character or 
combination of characters entered after the two switch 
characters are considered data characters. 


It is advisable to specify nonordinary characters as switch 
characters, for example, non-system-specific CTRL-key 
combinations. 
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2.5 STATUS RETURNS 


Table 2-6 lists error and status conditions that are returned by the 
terminal driver to the I/O status block. 


Most Micro/RSX error and status codes returned are byte values in the 
status word. For example, the value for IS.SUC (success) is 1 and is 
placed in the low byte of the first status word. However, IS.CC, 
IS.CR, IS.ESC, and IS.ESQ are word values in the first word of the 
status block. They show what type of completion occurred. 


To test for one of these word-value return codes, first test the low 
byte of the first word of the I/O status block for the value IS.SUC. 
Then, test the full word for IS.CC, IS.CR, IS.ESC, or IS.ESQ. (If the 
full word tests equal to IS.SUC, then its high byte is 0, indicating 
byte-count termination of the read.) 


The "error" return IE.EOF may be considered a successful read because 
characters returned to the task's buffer can be terminated by a CTRL/Z 
character. 


The SE.xxx codes are returned by the SF.GMC and SF.SMC functions that 
are described in Sections 2.4.14 and 2.4.15. When any of these codes 
are returned, the low byte in the first word in the I/O status’ block 
contains IE.ABO. The second IOSB word contains an offset (starting 
from 0) to the byte in error in the QIOS's stadd buffer. 


Table 2-6 
Terminal Status Returns 


Code Reason 


IE.ABO Operation aborted 


The specified I/O operation was canceled by I0O.KIL 
while in progress or while in the I/O queue. The 
second word of the I/O status block indicates’ the 
number of bytes that were put in the buffer before 
the kill was effected. 


IE.BAD Bad parameter 
The size of the buffer exceeds 8128 bytes. 
IE.BCC Framing error 


A framing error was hardware-detected and returned by 
the controller. All characters up to (but not 
including) the erroneous character are in the buffer. 
This condition can result by pressing the BREAK key 
on some terminals, or by hardware problems. 


IE.DAA Device already attached 


The physical device unit specified in an I0O.ATT 
function was already attached by the issuing task. 
This code indicates that the issuing task has already 
attached the desired physical device unit, not that 
the unit was attached by another task. If the attach 
specified TF.AST or TF.ESQ, these subfunction bits 
have no effect. 


(continued on next page) 
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Table 2-6 (Cont.) 
Terminal Status Returns 
Code Reason 
IE.DAO Data overrun error 


A data overrun error: was hardware-detected and 


returned by the controller. All characters up to 
(but not including) the erroneous character are in 
the buffer. This error occurs when a hardware 


failure or incompatibility causes characters to be 
received by the controller faster than they can be 
processed (that is, an incorrect serial I/O baud rate 
or format exists). 


IE.DNA Device not attached 


The physical device unit specified in an I0.DET 
function was not attached by the issuing task. This 
code has no bearing on the attachment status of other 
tasks. 


IE.DNR Device not ready 


The physical device unit specified in the QIO 
directive was not ready to perform the desired I/0 
operation. This code is returned to indicate one of 
the following conditions: 


e A time-out occurred on the physical device unit 
(that is an interrupt was lost). 


@e An attempt was made to perform a function on a 
remote DHV11 or DZV11l line without carrier 
present. 


IE.EOF Successful completion on a read with end-of-file 


The line of input read from the terminal was 
terminated with the end-of-file character CTRL/Z. 
The second word of the I/O status block contains’ the 
number of bytes read before CTRL/Z was seen. The 
input buffer contains those bytes. 


IE. IES Invalid escape sequence 


An escape sequence was started but escape-sequence 
syntax was violated before the sequence was 
completed. (See Section 2.7) The character causing 
the violation is the last character in the buffer. 


IE. IFC Illegal function 


A function code specified in an I/0 request was 
invalid for terminals; or, the function code 
specified was a system generation option not selected 
for this system. 


IE.NOD Buffer allocation failure 
System dynamic storage has been depleted resulting in 
insufficient space available to allocate an 
intermediate buffer for an input request or an AST 
block for an attach request. 


(continued on next page) 
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Table 2-6 (Cont.) 
Terminal Status Returns 


Coce Reason 


IE.OFL Device off line 


The physical device unit associated with the LUN 
specified in the QIO directive was not on line. When 
the system was booted, a device check indicated that 
this physical device unit was not in the 
configuration. The physical device unit could have 
been configured off line. 


IE.PES Partial escape sequence 
An eScape sequence was started, but read-buffer space 
was exhausted before the sequence was completed. See 
Section 2.7. 

IE.PRI Privilege violation 
A nonprivileged task issued an I0O.WBT, directed an 
SF.SMC to a terminal other than TI:, or it attempted 
to set its privilege bit. 


IE.SPC Illegal address space 


This error can indicate one or more of the’ following 
errors: 


e The buffer specified for a read or write request 
was partially or totally outside the address space 
of the issuing task 


e You specified a byte count of 0 
e You specified an odd or 0 AST address 


e You specified a TF.XCC and AST2 in the same QIOS 
request. 


IE.VER Character parity error 


A parity error was hardware-detected and returned by 
the controller. All characters up to (but = not 
including) the erroneous character are in the buffer. 


IS.cc Successful completion on a read 
The line of input read from the terminal was 
terminated by a CTRL/C. The input buffer contains 
the bytes read. 


IS.CR Successful completion on a read 


The line of input read from the terminal was 
terminated by a carriage return. The input buffer 
contains the bytes read. 


(continued on next page) 
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Table 2-6 (Cont.) 
Terminal Status Returns 


Code Reason 
IS.ESC Successful completion on a read 


The line of input read from the terminal was 
terminated by an ALTmode character. The input buffer 
contains the bytes read. 


IS.ESQ Successful completion on a read 


The line of input read from the terminal was 
terminated by an escape sequence. The input buffer 
contains the bytes read and the escape sequence. 


IS.PND I/O request pending 


The operation specified in the QIOS directive has not 
yet been executed. The I/O status block is filled 
with Os. 


IS.SUC Successful completion 


The operation specified in the QIO directive was 
completed successfully. If the operation involved 
reading or writing, you can examine the second word 
of the I/0 status block to determine the number of 
bytes processed. The input buffer contains those 
bytes. 


IS.TMO Successful completion on a read 


The line of input read from the terminal was 
terminated by a time-out (TF.TMO was set and the 
specified time interval was exceeded). The input 
buffer contains the bytes read. 


SE.ATA The terminal is attached with AST notification 
enabled. 

SE.BIN An invalid value for a binary characteristic was used 
in SF.SMC. 

SE.FIX An attempt was made to change a fixed characteristic 


in a SF.SMC subfunction request (for example, an 
attempt was made to change the unit number). 


SE.IAA An invalid AST address was specified. 
SE.NAT The terminal is not attached. 
SE.NIH A terminal characteristic other than those in Table 


2-4 was named in an SF.GMC or SF.SMC request, or a 
task attempted to assert TC.PRI. 


(continued on next page) 
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Table 2-6 (Cont.) 
Terminal Status Returns 


Code Reason 


SE.NSC An attempt was made to change a nonsettable 
characteristic. This error can occur when an attempt 
is made to make a local-only line a remote line when 
the controller does not support remote lines. 


SE.SPD The new speed specified in an SF.SMC_ subfunction 
request was not valid for the controller associated 
with the specified terminal. 


SE.UPN There was not enough room in pool for the terminal 
driver to allocate buffer space. 


SE.VAL The new value specified in an SF.SMC request for the 
TC.TTP terminal characteristic was not one of those 
listed in Table 2-5. 


2.6 CONTROL CHARACTERS AND SPECIAL KEYS 


This section describes the meanings of special terminal control 
characters and keys for Micro/RSX. Note that the driver does not 
recognize control characters and special keys during a Read All 
request (IO.RAL), or a Read with Special Terminators (I0.RST). 


2.6.1 Control Characters 


A control character is input from a terminal by holding the control 
key (CTRL) down while typing one other key. Three of the control 
characters described in Table 2-7, CTRL/R, CTRL/U, and CTRL/Z, are 
echoed on the terminal as “R, “U, and “Z, respectively. 


Table 2-7 
Terminal Control Characters 


Character Meaning 


CTRL/C If the command line interpreter (CLI) is DCL, which 
is the CLI for Micro/RSX, CTRL/C either aborts all 
currently active tasks invoked from the terminal or 
gives a DCL> prompt. To setup CTRL/C to abort, the 
terminal characteristics bit (TC.TLC) must be set. 
For more information refer to Section 2.6.2. 


CTRL/I CTRL/I or TAB characters initiate a horizontal tab, 
and the terminal spaces to the next tab stop. Tabs 
at every eighth character position are simulated by 
the terminal driver. This character has no special 
function if IO.RAL, IO.RST, TF.RAL, TF.RST or TFE.RPT 
are invoked, and it is treated as a normal character. 


(continued on next page) 
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Table 2-7 (Cont.) 
Terminal Control Characters 


Character Meaning 
CTRL/J CTRL/J is equivalent to a LINE FEED character. This 


character has no special function if IO.RAL, IO.RST, 
TF.RAL, TF.RST or TEF.RPT are invoked, and it is 
treated as a normal character. 


CTRL/K CTRL/K initiates a vertical tab, and the terminal 
tabs to the next vertical tab _ stop. For a CRT 
terminal, four LINE FEEDs are output. This character 
has no special function if IO.RAL, IO.RST, TF.RAL, 
TF.RST or TF.RPT are invoked, and it is treated as a 
normal character. 


CTRL/L CTRL/L initiates a formfeed. If the terminal has 
hardware formfeed support, the driver echos CTRL/L. 
Otherwise, the driver simulates the formfeed by 
outputting enough LINE FEED characters to advance the 
next character position to the top of the next page. 
If a CRT terminal is in use, four LINE FEEDs are 
output. This character has no special function if 
IO.RAL, IO.RST, TF.RAL, TF.RST or TF.RPT are invoked, 
and it is treated as a normal character. 


CTRL/M CTRL/M is equivalent to a RETURN character (see 
Section 2.6.3). This character has no_ special 
function if IO.RAL, IO.RST, TF.RAL, TF.RST or TF.RPT 
are invoked, and it is treated as a normal character. 


CTRL/O If the passthrough terminal characteristic has been 
set (TC.PTH), or if IO.RAL or TF.RAL is enabled 
CTRL/O is treated as a normal character. Otherwise, 
CTRL/O suppresses terminal output. In addition, for 
attached terminals, CTRL/O remains in effect (output 
is suppressed) until one of the following occurs: 

e The terminal is detached. 

@ Another CTRL/O character is typed. 

e An I0.CCO or IO.WBT function is issued. 

e Input is entered. 

e I0O.RPR is issued at the terminal. 

For unattached terminals, CTRL/O suppresses output 
for only the current output buffer (typically one 
line). 


(continued on next page) 


Character 


CTRL/Q 


CTRL/S 


CTRL/R 


CTRL/U 


CTRL/X 


CTRL/Z 
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Table 2-7 (Cont.) 
Terminal Control Characters 


Meaning 


If IO.RAL or TF.RAL is enabled, CTRL/Q is treated as 
a normal character. Otherwise, CTRL/Q resumes 
terminal output previously suspended by means of 
CTRL/S only if the terminal characteristic TC.TSY has 
been enabled. 


CTRL/S suspends terminal output except if IO.RAL or 
TF.RAL is enabled. (Output can be resumed by typing 
CTRL/Q or CTRL/C.) This applies only to terminals for 
which TTSYNC is enabled. You can enable TTSYNC by 
setting the TC.TSY terminal characteristic bit. 


If TF.RNF, IO.RAL, TF.RAL, IO.RST, TF.RST, or TF.RPT 
are enabled, CTRL/R is treated as a normal character. 
Otherwise, typing CTRL/R results in a carriage return 
and line feed being echoed, followed by the 
incomplete (unprocessed) input line. Any tabs that 
were input are expanded and the effect of any rubouts 
is shown. On hardcopy terminals, CTRL/R allows 
verifying the effect of a tab or a rubout, or both, 
in an input line. CTRL/R allows verifying the 
effects of tabs or rubouts in an input line. For 
example, after rubbing out the left-most character on 
the second displayed line of a wrapped input line, 
the cursor does not move to the right of the first 
displayed line. In this case, CTRL/R brings the 
input line and the cursor back together again. 


If TF.RNF, IO.RAL, TF.RAL, IO.RST, TF.RST, or TFE.RPT 
are enabled, CTRL/U is treated as a normal character. 
Otherwise, typing CTRL/U before typing a line 
terminator deletes previously typed characters back 
to the beginning of the line. The system echoes this 
character as “U followed by a carriage return and a 
line feed. 


If IO.RAL, TF.RAL, IO.RST, TEF.RST, or TF.RPT are 
enabled, CTRL/X is treated as a normal character. 
Otherwise, CTRL/X clears the type-ahead buffer. 


If IO.RAL, TF.RAL, IO.RST, TE.RST, or TF.RPT are 
enabled, CTRL/Z is treated as a normal character. 
Otherwise, CTRL/Z indicates an end-of-file for the 
current terminal input. It signals MAC, TKB, and 
other system tasks that terminal input is complete, 
allowing the task to exit. The system echoes this 
character as “Z, followed by a carriage return and a 
line feed. 
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2.6.2 CTRL/C Processing 


The terminal driver can pass CTRL/C characters directly to the 
terminal's CLI for processing instead of doing the processing itself. 
Under these conditions, it is the CLI that is programmed to respond to 
a CTRL/C typed at a terminal. For instance, the DCL command line 
interpreter responds by aborting all currently active tasks invoked 
from the terminal. For the terminal driver to behave this way, both 
the CLI and the terminal must be set to handle CTRL/C characters. The 
terminal driver passes CTRL/C processing to a CLI only when the CLI is 
initialized to process CTRL/C notification packets and the terminal is 
set to trap CTRL/C characters. 


To setup CLI CTRL/C processing, use the CTRLC switch in the CLI 
command as follows: 


CLI /NAME=cliname/CTRLC 


(This command sets CP.CTC in the CLI's CPB. Micro/RSX DCL is already 
initialized this way.) 


To set a terminal to trap CTRL/C characters you must set the TC.TLC 
terminal characteristics bit. This done by a SET command as follows: 


SET TERM/CONTROL=C 
At the QIO level a SF.SMC QIO is used to set the TC.TLC bit. 


If the CLI and the terminal are initialized to handle CTRL/C 
characters, the terminal driver flushes the buffer, checks for ASTs, 
and creates a CLI notification packet that is passed to the CLI on 
behalf of the terminal. (A CLI notification packet is not created if 
a CTRL/C AST occurs from a task attached to a terminal.) The terminal 
Griver takes no other action. At this point the CTRL/C notification 
packet is available to the CLI like a regular command line. The CLI 
can identify and process it however it wants to. 


If the CLI and terminal are not initialized to process CTRL/C 
characters, typing CTRL/C causes unsolicited input on that terminal to 
be directed to a control line interpreter task, such as DCL, if the 
terminal is not attached. (Command line interpreters are invoked and 
display a prompt in a manner similar to that of DCL; therefore, for 
the purposes of this discussion, it is assumed that DCL is the command 
line interpreter in use, although the terminal driver will respond to 
other command line interpreters in a similar manner.) The DCL> prompt 
is echoed when the terminal driver is ready to accept an _ unsolicited 
DCL command line for input. When the unsolicited input is terminated, 
the command line is passed to DCL. 


If the last character typed on the terminal was a CTRL/S (suspend 
output), CTRL/C restarts suspended output and directs subsequent input 
to DCL. 


CTRL/C characters can also be directed to a task if the task has 
attached a terminal and has specified an unsolicited-input-character 
AST (see Section 2.4.2). CTRL/C characters are also passed to a_ task 
if an IO.RAL or IO.RST function is effected. 


If the terminal driver receives a CTRL/C character during a_ read 
operation (except during a Read-Pass-All operation or a Read With 
Special Terminators operation), the read operation is terminated, the 
pee ee buffer is cleared, and an IS.CC status code is returned to 
the task. 
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2.6.3 Special Keys 


The ESCape, carriage RETURN (or RUBOUT) keys have special significance 
for terminal input, as described in Table 2-8. A line can be 
terminated by an ESCape (or ALTmode), carriage RETURN, or CTRL/Z 
characters, or by completely filling the input buffer (that is, by 
exhausting the byte count before a line terminator is typed). The 
standard buffer size for a terminal can be determined for a task by 
issuing a Get LUN Information system directive and examining Word 5 of 
the buffer. An operator can obtain the same information with the DCL 
SHOW TERM/width command. 


Table 2-8 
Special Terminal Keys 


Key Meaning 


ESCape If IO.RAL, TF.RAL, or TF.RPT are enabled, ESCape is 
treated as a normal character. Otherwise, if escape 
sequences are not recognized, typing ESCape or 
ALTmode signals the terminal driver that there is no 
further input on the current line. This line 
terminator allows further input on the same line, 
because the carriage or cursor is not returned to the 
first column position. 


If escape sequences are recognized, ESCape signals 
the beginning of an escape sequence. (See Section 
2.7.) 


RETURN If IO.RAL, TEF.RAL, or TF.RPT are enabled, RETURN is 
treated as a normal character. Otherwise, typing 
RETURN terminates the current line and causes’ the 
carriage or cursor to return to the first column on 
the line. 


RUBOUT If TF.RNF (read no filter) is enabled, RUBOUT is 
treated as a normal character. Otherwise, typing 
DELETE or RUBOUT deletes the last character typed on 
an input line. Only characters typed since the last 
line terminator may be deleted. Several characters 
can be deleted in sequence by typing successive 
DELETES or RUBOUTs. 


For example, on a printing terminal, the first DELETE 
or RUBOUT echoes a backslash (\) followed by the 
character that has been deleted, even if the terminal 
is in the no-echo mode. Subsequent DELETES or 
RUBOUTS cause only the deleted character to be 
echoed. The next character typed that is not a 
DELETE or RUBOUT causes another backslash to be 
printed, followed by the new character. The 
non-RUBOUT character is not echoed if the terminal is 
in the no-echo mode; however, a backslash is echoed 
in response to the first non-RUBOUT character. The 
following example illustrates rubbing out ABC and 
then typing CBA: 


ABC\CBA\CBA 


(continued on next page) 
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Table 2-8 (Cont.) 
Special Terminal Keys 


Key Meaning 


The second backslash is not displayed if a line 
terminator is typed after rubbing out the characters 
on a line, as in the following example: 


ABC\CBA 


If the CRT rubout feature was selected, DELETE or 
RUBOUT causes the last typed character (if any) to be 
removed from the incomplete input line, and a 
backspace-space-backspace sequence of characters for 
that terminal is echoed. If the last typed character 
was a tab, enough backspaces are issued to move the 
cursor to the character position before the tab was 
typed. If a long input line was split, or “wrapped," 
by the automatic-carriage-return option, and a RUBOUT 
erases the last character of a previous line, the 
cursor is not moved to the previous line. Your’. task 
must use CTRL/R to resynchronize the current display 
with the contents of the incomplete input line. 


2.7 ESCAPE SEQUENCES 


Escape sequences are strings of two or more characters beginning with 
an ESC (033) character. Some terminals generate an escape sequence 
when a special key is pressed. On any terminal, an escape sequence 
may be generated manually by typing ESCape followed by the appropriate 
characters. 


Escape sequences provide a way to pass input to a task without 
interpretation by the operating system. This could be done with a 
number of Read All functions, but escape sequences allow input to _ be 
read with IO.RLB requests. 


2.7.1 Definition of Escape Sequence Format 


The format of an escape sequence defined by American National Standard 
X 3.41-- 1974 and used in the VT100 is: 


ESC ... F 


where: 

ESC The introduced control character (33 octal) that is named 
escape. 

eee The intermediate bit combinations that may or may not be 
present. These characters are bit combination 40(octal) to 
57(octal) inclusive in both 7- and 8-bit environments. 

F The final character. F characters are bit combinations 60 


(octal) to 176 (octal) inclusive in escape sequences in both 
7- and 8-bit environments. 
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The occurrence of characters in the inclusive ranges O(octal) to 
37(octal) is technically an error condition. The recovery from this 
error occurs upon immediate execution of the function specified by the 
character and the continuation of the escape sequence execution. The 
exceptions are: if the character ESC occurs, the current escape 
sequence is aborted, and a new one commences, beginning with the ESC 
just received; if the character CAN 30 (octal) or the character SUB 32 
(octal) occurs, the current escape sequence is aborted, as is the case 
with any control character. 


There are five exceptions to this general definition; these exceptions 
are discussed in Section 2.7.5. 


2.7.2 Prerequisites 


There are prerequisites that must be satisfied before escape sequences 
can be received by ae task. First, the terminal must be declared 
capable of generating escape sequences. This may be done with the DCL 
SET command: 


SET TERM/ESCAPE 


After this prerequisite is satisfied, one of the following 
prerequisites must be met: 


l. You must attach the terminal with IO.ATT!TF.ESQ. 


2. You must use the TF.RES modifier with the IO.EIO!TF.RLB 
function. 


NOTE 


The second method enables escape recognition 
for only the duration of the read function. 


If these prerequisites are not satisfied, the ESC character is treated 
as a line terminator. If these prerequisites are satisfied, your task 
may use CTRL/SHIFT/O (017 octal) as an ALTmode character. However, 
this character does not act as an ALTmode from a terminal that cannot 
generate escape sequences. 


An ALTmode is a line terminator that does not cause the cursor to 
advance to a new line. On terminals that cannot generate escape 
sequences, the ESC key acts as an ALTmode. Characters 175 and 176 
also function as ALTmodes if the terminal has not been declared 
lowercase (DCL command SET TERM/LOWERCASE). 


2.7.3 Characteristics 


Escape sequences always act as line terminators. That is, an input 
buffer may contain other characters that are not part of an escape 
sequence, but an escape sequence always comprises the last characters 
in the buffer. 


Escape sequences are not’ echoed. However, if a non-CRT- rubout 
sequence is in progress, it is closed with a backslash when an escape 
sequence is begun. 


Escape sequences are not recognized in unsolicited input streams. 
Neither are they recognized in a Read All (subfunction bit TF.RAL). 
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2.7.4 Escape Sequence Syntax Violations 


A violation of the syntax defined in Section 2.7.1 causes the driver 
to abandon the escape sequence and to return an error (IE.IES). 


2.7.4.1 DELETE or RUBOUT (177) - The character DELETE or RUBOUT is 
not legal within an escape sequence. Typing it at any point within an 
escape sequence causes the entire sequence to be abandoned and deleted 
from the input buffer. Thus, use DELETE or RUBOUT to abandon an 
escape sequence, if desired, once you have begun it. 


2.7.4.2 Control Characters (0-037) - The reception of any except four 
characters in the range 0 to 037. is a syntax violation that 
terminates the read with an error (IE.IES). 


The four control characters that are allowed are: CTRL/Q, CTRL/S, 
CTRL/X, and CTRL/O. These characters are handled normally by the 
operating system even when an escape sequence is in progress. For 
example, entering: 


ESC CTRL/S A 


gives: 


with the additional effect of turning off the output stream. 


2.7.4.3 Full Buffer - A syntax error results when an escape sequence 
is terminated by running out of read-buffer space, rather than by 
receipt of a final character. The error IE.PES is’ returned. For 
example, after a task issues an IO.RLB with a buffer length of 2, and 
you type: 


ESC ! A 


the buffer contains "ESC !", and the I/O status block contains: 


The "A" is treated as unsolicited input. 


2.7.5 Exceptions to Escape Sequence Syntax 


Five "final characters" that normally terminate an escape sequence are 
treated as special cases by the terminal driver for use with certain 
terminals: 


ESC ?... 
ESC 0... 
ESC P... 
ESC Y... 
ESC [... 
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Refer to documentation supplied with the specific terminal(s) in use 
for correct use of escape sequences. 


2.8 VERTICAL FORMAT CONTROL 


Table 2-9 is a summary of all characters that your task can use _ for 
vertical format control on the terminal. Any one of these characters 
can be specified as the value of the vfc parameter in IO.WLB, IO.WVB, 
IO.WBT, I0.CCO, or IO.RPR functions. 


Table 2-9 
Vertical Format Control Characters 


Octal 
Value Character Meaning 


040 blank SINGLE SPACE - The driver outputs one line feed, 
prints the contents of the buffer, and outputs a 
carriage return. Normally, printing immediately 
follows the previously printed line. 


060 0 DOUBLE SPACE - The driver outputs two line 
feeds, prints the contents of the buffer, and 
outputs a carriage return. Normally, the buffer 
contents are printed two lines below the 
previously printed line. 


061 1 PAGE EJECT - If the terminal supports FORM 
FEEDs, the driver outputs a form feed, prints 
the contents of the buffer, and outputs a 
carriage return. If the terminal does not 
support FORM FEEDS, the driver simulates’ the 
FORM FEED character by either outputting four 
line feeds to a crt terminal, or by outputting 
enough line feeds to advance the paper to the 
top of the next page on a printing terminal. 


053 + OVERPRINT - The driver prints the contents of 
the buffer and outputS a carriage return, 
normally overprinting the previous line. 


044 S PROMPTING OUTPUT -—- The driver outputs one 
line feed and prints the contents of the buffer. 
This mode of output is for use with a terminal 
on which a prompting message is output, and 
input is then read on the same line. 


000 null INTERNAL VERTICAL FORMAT - The driver prints the 
buffer contents without addition of vertical 
format control characters. In this mode, more 
than one line of guaranteed contiguous output 
can be printed for each I/0 request. 


All other vertical format control characters are interpreted as blanks 
(040). 
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2.9 AUTOMATIC CARRIAGE RETURN 


Individual terminals can be set for wrap-around, as desired, using the 
DCL SET command 


SSET TERM/WRAP 


Once wrap-around has been selected, the column at which wrap-around 
occurs can be selected using the DCL command 


SSET TERM/WIDTH 
$ 


The SHOW TERM/WIDTH command can display the current buffer width for a 
terminal: 


SSHOW TERM/WIDTH 
BUF=TI: 00072. 
$ 


A task can determine the buffer width by issuing a Get LUN Information 
directive and examining word 5 returned in the buffer. 


After the SET has been done, typing beyond the buffer width results in 
a carriage return and line feed being output before the next character 
is echoed. Although only one line was input, it is displayed on two 
terminal lines. 


It is possible to lose track of where you are in the input buffer if 
wrap-around is enabled for your terminal. For example, while deleting 
text on a wrapped line, the cursor does not back up to the previous 
line. To resynchronize the cursor with the contents of the incomplete 
input buffer, type CTRL/R. 


2.10 HARD RECEIVE ERROR DETECTION 


All terminal interfaces supported by the full-duplex terminal driver 
are capable of detecting and flagging hard receive errors. Hard 
receive errors include framing errors, enable character parity error, 
and data overrun error. 


The driver handles hard receive errors as follows: 
1. If a read request is being processed and the character can be 


processed immediately, the read request is terminated with 
one of the following error codes returned in the status 


block: 
Error 
Code Hard Receive Error 
IE.BCC Framing error 
IE.DAO Data overrun 
IE.VER Character parity error 


2. If a command line is being input for a command line 
interpreter task and the character can be processed 
immediately, a CTRL/U is simulated, “U is echoed, and _ the 
input is terminated. No command line is sent to the task. 


3. If the character would normally cause an AST if no error was 
detected, the character is ignored and no AST occurs. 
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4. If the character cannot be processed immediately, it is 
stored in the type-ahead buffer. A flag is set for the line, 
indicating that the last character in the type-ahead buffer 
has an error, disabling further storage in the type-ahead 
buffer. When the character is retrieved from the buffer, the 
appropriate action previously described is taken and the flag 
is cleared. Any characters received in the meantime are 
discarded, with a bell echoed for each character. 


2.11 TASK BUFFERING OF RECEIVED CHARACTERS 

When task-buffering received characters, characters read from the 
terminal are sent directly to the task's buffer. Thus, there is no 
need to allocate a terminal driver buffer. 


Task buffering of received characters does not necessarily reduce 


system overhead. For example, each character must be mapped to the 
task's buffer. However, if terminal driver buffering was used, the 
system does the mapping only once for all characters to be 


transferred. 


With the full-duplex terminal driver, output buffering is always 
performed. 


Task buffering is overridden during checkpointing. If a task is 
checkpointable, a driver buffer is allocated and the task is made 
eligible for checkpointing by any task, regardless of priority, while 
the read operation is in progress. (Checkpointing occurs in this 
situation only when there is another task that can be made active.) 
Because checkpointability is controlled by the task, you retain 
control over this operation. 


2.12 TYPE-AHEAD BUFFERING 


Characters received by the terminal driver are either processed 


immediately or stored in the type-ahead buffer. The type-ahead buffer 
allows characters to be temporarily stored and retrieved FIFO. The 


terminal driver uses the type-ahead buffer as follows: 
l. Store in buffer: 


An input character is stored in the type-ahead buffer if one 
or more of the following conditions are true: 


e The driver is not ready to accept the character (fork 
process pending or in progress). 


e There is at least one character presently in the 
type-ahead buffer. 


@e The character input requires echo and the output line to 
the terminal is presently busy outputting a character. 


@ No read request is in progress, no unsolicited input AST 
is specified, and the terminal is attached or slaved and 
attached. 
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NOTE 


Depending on the terminal mode and the presence of 
a read function, read subfunctions and an 
unsolicited input AST, the CTRL/C, CTRL/O, CTRL/Q, 
CTRL/S, and CTRL/X characters may be processed 
immediately and not stored in the type-ahead 
buffer. 


A character is not echoed when it is stored in the buffer. 
Echoing a character is deferred until it is retrieved from 
the buffer, because the read mode (for example, 
read-without-echo) is not known by the driver until then. 


2. Retrieve from buffer: 


When the driver becomes ready to process input, or when a 
task issues a read request, an attempt is made to retrieve a 
character from the buffer. If this attempt is successful, 
the character is processed and echoed, if required. The 
driver then loops, retrieving and processing characters until 
either the buffer is empty, the driver becomes unable to 
process another character, or a read request is finished with 
the terminal attached. 


3. Flush the buffer: 
The buffer is flushed (cleared) when: 
e cCTRL/C is received. 
e cCTRL/X is received. 
e A clear out-of-band character is entered. 
e Switch characters are detected. 
e The terminal becomes detached. 


Exceptions: CTRL/C and CTRL/X do not flush the buffer if 
read-pass-all or read-with-special-terminators is in effect. 


If the buffer becomes full, each character that cannot be entered 
causes a BELL character to be echoed to the terminal. 


If a character is input and echo is’ required, but the transmitter 
section is busy with an output request, the input character is held in 
the type-ahead buffer until output (transmitter) completion occurs. 


2.13 FULL-DUPLEX OPERATION 


When a terminal line is in the full-duplex mode, the full-duplex 
driver attempts to simultaneously service one read request and one 
write request. The Attach, Detach and Set Multiple Characteristics 
functions are performed with the line in an idle state only (not 
executing a read or a write request). 
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2.14 PRIVATE BUFFER POOL 


The driver has a private buffer pool for intermediate input and output 
buffers. Whenever the driver needs dynamic memory, it first attempts 
to allocate a buffer in the private pool. If this fails, a second 
attempt is made in the system pool. If the allocation in the system 
pool fails during command line input, a CTRL/U is simulated and 
echoed. 


Command line interpreter task buffers are handled in a special way. 
When unsolicited input begins, a buffer is allocated, as previously 
described, for the command line (a string of characters, followed by 
an appropriate terminator character). When the input is completed, 
secondary pool is allocated, the command line is copied into it, and 
it is queued to the CLI for processing. 


2.15 INTERMEDIATE INPUT AND OUTPUT BUFFERING 


Input buffering for checkpointable tasks with checkpointing enabled is 
provided in the private pool. As each buffer becomes full, a new 
buffer is automatically allocated and linked to the previous buffer. 
The Executive then transfers characters from these buffers to the task 
buffer and the terminal driver deallocates the buffers once the 
transfer has been completed. 


If the driver fails to allocate the first input buffer, the characters 
are transferred directly into the task buffer. If the first buffer is 
successfully allocated, but a subsequent buffer allocation fails, the 
input request terminates with the error code IE.NOD. In this case, 
the I/O status block contains the number of characters actually 
transferred to the task buffer. The task may then update the buffer 
pointer and byte count and reissue a read request to receive the rest 
of the data. The type-ahead buffer ensures that no input data is 
lost. 


All terminal output is buffered. As many buffers as required are 
allocated by the terminal driver and linked to a list. If not enough 
buffers can be obtained for all output data, the transfer is done as a 
number of partial transfers, using available buffers for each partial 
transfer. This is transparent to the requesting task. If no buffers 
can be allocated, the request terminates with the error code IE.NOD. 


The unconditional output buffering serves three purposes: 
1. It reduces time spent at interrupt level. 
2. It enables long DMA transfers for DHV11 controllers. 


3. It enables task checkpointing during the transfer to the 
terminal (if all output fits in one buffer list). 


2.16 TERMINAL-INDEPENDENT CURSOR CONTROL 


The terminal driver responds to task I/O requests’ for cursor 
positioning without the task requiring information about the type of 
terminal in use. I/O functions associated with cursor positioning are 
described as follows. 
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Cursor position is specified in the vfc parameter of the I0.WLB_ or 
IO.RPR function. The parameter is interpreted simply as a vfc 
parameter if the high byte of the parameter is 0. However, if the 
parameter defines cursor position, the high byte must be nonzero, the 
low byte is interpreted as column number (x-coordinate), and the high 
byte is interpreted as line number (y-coordinate). Home position, the 
upper left corner of the display, is defined as 1,1. Depending upon 
terminal type, the driver outputs appropriate cursor-positioning 
commands appropriate for the terminal in use that move the cursor. to 
the specified position. If the most significant bit of the line 
number is set, the driver clears the display before positioning the 
cursor. 


When defining cursor position in an IO.WLB function, you can use _ the 
TF.RCU subfunction to save the current cursor position. When included 
in this manner, TF.RCU causes the driver to first save the current 
cursor position, then position the cursor and output the specified 


buffer, and, finally, restore the cursor to the original (saved) 
position once the output transfer has been completed. 


2.17 PROGRAMMING HINTS 
2.17.1 Modem Support 
The terminal driver supports the following modem control operations: 

e Local or remote operation 

@ Answer speed 

e Auto-baud speed detection 
The characteristics bit that controls local or remote operation is 
TC.DLU. This bit can be set with the DCL command SET TERMINAL REMOTE 
(or SET TERMINAL LOCAL). 


When there is an incoming call on a remote line, the MTC.ASP 
characteristic determines the baud rate for the answering modem. 


Split baud rates (different transmit and receive speeds) are not 
supported for answer speed. 


The answer speed can be set on line using the DCL command 
SET/TERM/REMOTE/SPEED:brate. 


The terminal driver can determine the speed of the incoming call by 
sampling the first input character after dial-up for the following 
speeds: 


110 1800 
150 2400 
300 4800 
600 9600 
1200 


This is called auto-baud speed detection. This option can be selected 
for each line using the SET TERM/AUTOBAUD command. This command sets 
the TC.ABD terminal characteristic. When auto-baud speed detection is 
set for a given line, the terminal driver attempts to sense the baud 
speed of the caller when that line is set to remote and a call has 
been received. For auto-baud speed detection to work correctly, the 
user should input carriage returns when first establishing the remote 
connection until the CLI prompt is displayed on the screen. 
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2.17.2 Checkpointing During Terminal Input 


If checkpointing during terminal input was selected as a system 
generation option, a checkpointable task is stopped (and therefore 
eligible to be checkpointed) when trying to read. Therefore, a 
stratagem such as issuing a _ read followed by a mark-time does not 
work. The intent might be to time out the read if input is not 
received in a reasonable length of time. But the mark-time is not 
issued until the read completes. 


You can circumvent this behavior by disabling checkpointing for the 
read. This is not a desirable solution because it forces a task to 
remain in memory during the entire read. This defeats the purpose of 
selecting the checkpoint-during-terminal-input option. 


CHAPTER 3 


DISK. DRIVERS 


3.1 INTRODUCTION 


The Micro/RSX System has the following loadable disk drivers: 


3.1.1 DUDRV.TSK 


The DUDRV driver processes I/O requests for the RQDX1/RQDX2 
controller. The RQDX1/RQDX2 controller is for the RD51-A and the 
RD52. The RD51 is a 10-megabyte fixed Winchester disk and _ the 
RX50-AA, a dual 400 kilobyte 5.25-inch diskette drive, both of which 
are included with a delivered Micro/RSX System. The RD52 is a 
30.97-megabyte fixed Winchester disk. 


The DUDRV driver also processes I/0 requests for the RC25 
fixed/removable disk system and the KDA50 controller. 


3.1.1.1 RC25 Disk Hardware Description - The RC25 disk subsystem 
consists of a fixed-media drive and a removable-media drive, both of 
which revolve on the same spindle and share the same head mechanics. 
Each drive is a logical unit, so each RC25 disk subsystem consists of 
two logical units. 


RC25 subsystems are available in two types: a master drive that 
contains its own controller, and a slave drive, which must be 
connected to an RC25 master drive. Each RC25 master drive can support 
one RC25 slave drive. A master-slave configuration would contain four 
logical units. 


3.1.1.2 KDA50 Controller Hardware Description - The KDA controller is 
an intelligent disk controller that contains a high-speed 
microprogrammed processor capable of performing all disk functions, 
including data handling, error detection and correction, and 
optimization of disk drive activity and data transfers. The 
controller optimizes disk activity by reordering QIOs. Therefore, 
QIO$ macros may not complete in the order in which they were issued. 
Also, the KDA can carry out an extensive self-test on power-up or 
initialization. The types of drives that can be connected to the 
KDA50 controller are the RA60 disk drive, which has a removable pack, 
and the RA80 and RA81, both of which are fixed media drives. 
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3.1.2 DLDRV.TSK 


The DLDRV driver processes I/O requests for the RLV12 controller. 
This controller can handle from one to four 10-megabyte RLO2 disk 
drives. These drives take top-loading removable disk cartridges. 


3.1.3 DYDRV.TSK 


The DYDRV driver processes I/O requests for the RXV21 controller. 
This controller controls a tabletop diskette drive subsystem that has 
two RX02 disk drives. Each drive takes an 8-inch flexible diskette 
that has 512 kilobytes of storage. 


3.2 GET LUN INFORMATION MACRO 


Word 2 of the buffer filled by the Get LUN Information macro (the 
first characteristics word) contains the following information for 
disks. A bit setting of 1 indicates that the described characteristic 
is true for disks. 


Bit. Setting Meaning 

0 0 Record-oriented device 

Hi 0 Carriage-control device 

2 0 Terminal device 

3 1 File-structured device 

4 0 Single-directory device 

5 0 Sequential device 

6 1 Mass storage device 

7 X User-mode diagnostics supported (device 
dependent) 

8 X 22-bit direct addressing supported 

9 0 Unit software write-locked 

10 0 Input spooled device 

11 0 Output spooled device 

12 0 Pseudo-device 

13 0 Device mountable as a communications 
channel 

14 1 Device mountable as a Files-1l volume 

15 1 Device mountable 


Words 3 and 4 of the buffer contain the maximum logical block number. 
Note that the high byte of U.CW2 is undefined. You should clear the 
high byte in the buffer before using the block number. For DUDRV type 
disks, these two words are undefined until the device has been mounted 
at least once. Word 5 indicates the default buffer size, which is 512 
bytes for all disks. 
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3.3 QIO MACRO 


This section summarizes the standard and the device-specific QIO 
functions for disk drivers. 


3.3.1 Standard QIO Functions 
Table 3-1 lists the standard functions of the QIO macro that are valid 
for disks. 


Table 3-1 
Standard QIO Functions for Disks 


Format Function 
QIOSC IO.ATT,... Attach device! 
QIOSC IO.DET,... Detach device 
QIOSC I0.KIL,... Kill 1/0? 


QIOSC IO.RLB,...,<stadd,size,,blkh,blkl> Read logical block 
QIOSC I0.RVB,...,<stadd,size,,blkh,blkl> Read virtual block 
QIOSC IO.WLB,...,<stadd,size,,blkh,blkl> Write logical block 


QIOSC IO.WLC,...,<stadd,size, ,blkh,blkl> Write logical block 
followed by write 
check3 


QIOSC IO.WVB,...,<stadd,size,,blkh,blkl> Write virtual block 


l. Only volumes mounted foreign may be attached. Any other 
attempt to attach a mounted volume will result in an 
IE.PRI status being returned in the I/O status doubleword. 


2.  In-progress disk operations are allowed to complete when 
IO.KIL is received, because they take such a short time. 
I/O requests that are queued when IO.KIL is received are 
killed immediately. An IE.ABO status is returned in the 
I/O status doubleword. 


3. Not supported on RX02 flexible disks. 


stadd 


The starting address of the data buffer (must be on a_e word 
boundary). 


size 
The data buffer size in bytes. 

blkh/b1lkl 
Block high and block low, combining to form a double-precision 
number that indicates the actual logical/virtual block address on 


the disk where the transfer starts; blkh represents the high 8 
bits of the address, and blkl the low 16 bits. 


3-3 


DISK DRIVERS 


IO.RVB and IO.WVB are associated with file operations (see the 
RSX-11M/M-PLUS and Micro/RSX I/O Operations Reference Manual). For 
these functions to be executed, a file must be open on the specified 
LUN if the volume associated with the LUN is mounted. Otherwise, the 
virtual I/O request is converted to a logical I/O request using the 
specified block numbers. 


“NOTE 


When writing a new file using QIOs, the task must 
explicitly issue .EXTND File Control System library 
routine calls as necessary to reserve enough blocks 
for the file, or the file must be initially created 
with enough blocks allocated for the file. In 
addition, the task must put an appropriate value in 
the FDB for the end-of-file block number (F.EFBK) 
before closing the file. (Refer to the .EXTND routine 
description in the RSX-11M/M-PLUS and Micro/RSX I/0 
Operations Reference Manual.) 


Each disk driver supports the subfunction bit IQ.xX: inhibit retry 
attempts for error recovery. You invoke this subfunction bit by using 
it in a Logical OR with the desired QIO; for example: 

QIOScC IO.WLB!IQ.X,...,<stadd,size,,blkh,blkl> 


The IQ.X subfunction permits user-specified retry algorithms for 
applications in which data reliability must be high. 


The overlapped seek drivers for Micro/RSX support subfunction bit 


IQ.Q, which queues the request immediately without doing a seek (that 
is, uses implied seeks). 


3.3.2 Device-Specific QIO Functions 
The device-specific functions shown in Table 3-2 are valid only for 
the RX02 and the RLO2 disk drives. 


Table 3-2 
Device-Specific Functions for the 
RX02 and RLO2 Disk Drives 


Format Function 


QIOSC IO.RPB,...,<stadd,size,,,pbn> Read physical block 


OLOSC: TOsSEC pines Sense diskette characteristics 
(RX02 only) 


QIO$C IO.SMD,...,<density,,> Set media density (RX02 only) 


QIOSC IO.WDD,...,<stadd,size,,,pbn> Write physical block (with 
deleted data mark) ( RX02 only) 


QIOSC IO.WPB,...,<stadd,size,,,pbn> Write physical block 
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stadd The starting address of the data buffer (must be on a word 
boundary). 


size The data buffer size in bytes must be even and greater 
than 0. 
pbn The physical block number where the transfer starts (no 


validation will occur). 
density The media density as follows: 


0 
2 


single density 
double density 


3.3.3 Device-Specific QIO Function for DU: Devices 
The DUDRV driver supports the device-specific QIO function shown in 
Table 3-3. 


Table 3-3 
Device-Specific QIO Function for the DUDRV Disk Driver 


Format Function 
QIOSC IO.RLC,...,<stadd,size,,blkh,blkl> Read Logical with Read Check 


modifier 


The IO.RLC function is a read logical block followed by a read 
check. The disk is read twice. 


3.4 STATUS RETURNS 
The error and status conditions listed in Table 3-4 are returned by 


the disk drivers described in this chapter. 


Table 3-4 
Disk Status Returns 


Code Reason 


IS.SUC Successful completion 


The operation specified in the QIO macro was 
completed successfully. The second word of the I/0 
status block can be examined to determine the 
number of bytes processed, if the operation 
involved reading or writing. 


(Continued on next page) 


Code 


IS.PND 


IS.RDD 


IE.ABO 


IE.ALN 


IE.BLK 


IE.BBE 


IE.BYT 


IE.DNR 


IE. IFC 


DISK DRIVERS 


Table 3-4 (Cont.) 
Disk Status Returns 


Reason 


I/O request pending 

The operation specified in the QIO macro has not 
yet been executed. The I/O status block is filled 
with Os. 

Deleted data mark read 

A deleted record was encountered during execution 
of an IO.RPB function. The second word of the I/0 
status block can be examined to determine the 
number of bytes processed (RX02 only). 

Request aborted 


An I/O request was queued (not yet acted upon by 
the driver) when an IO.KIL was issued. 


File already open 

The task attempted to open a file on the _ physical 
device unit associated with specified LUN, but a 
file has already been opened by the issuing task on 
that LUN. 

Illegal block number 

An invalid logical block number was_ specified. 
IE.BLK would be returned if an attempt was made to 
write on the last track of an RLO2 disk. 

Bad block error 


The disk sector (biock) being read was marked aS a 
bad block in the header word. 


Byte-aligned buffer specified 

Byte alignment was specified for a buffer, but only 
word alignment is legal for disk. Alternatively, 
the length of a buffer is not an appropriate number 
of bytes. 

Device not ready 


The physical device unit specified in the QIO macro 
was not ready to perform the desired I/O operation. 


Illegal function 
A function code was specified in an I/O request 


that is invalid for disks. 


(Continued on next page) 


Code 


IE.NLN 


IE.NOD 


IE.OFL 


IE.OVR 


IE.PRI 


IE.SPC 


IE.VER 
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Table 3-4 (Cont.) 
Disk Status Returns 


Reason 


File not open 


The task attempted to close a file on the physical 
device unit associated with the specified LUN, but 
no file was currently open on that LUN. 


Insufficient buffer space 


Dynamic storage space has been depleted, and there 
was insufficient buffer space available to allocate 
a secondary control block. For example, if a_ task 
attempts to open a file, buffer space for the 
window and file control block must be supplied by 
the Executive. This code is returned when there is 
not enough space for this operation. 


Device off line 


The physical device unit associated with the LUN 
specified in the QIO macro was not on line. When 
the system was booted, a device check indicated 
that this physical device unit was not in the 
configuration. 


Illegal read overlay request 


A read overlay was requested, and the physical 
device unit specified in the QIO macro was not the 
physical device unit from which the task was 
installed. The read overlay function can only be 
executed on the physical device unit from which the 
task image containing the overlays was installed. 


Privilege violation 


The task that issued the request was not privileged 
to execute that request. For disk, this code is 
returned if a nonprivileged task attempts to read 
or write a mounted volume directly (that is, using 
IO.RLB or IO.WLB). Also, this code is returned if 
any task attempts to attach a mounted volume. 


Illegal address space 


The buffer specified for a read or write request 
was partially or totally outside the address space 
of the issuing task. Alternatively, a byte count 
of 0 was specified. 


Unrecoverable error 
After the system's standard number of retries has 
been attempted upon encountering an error, the 


operation still could not be completed. For disk, 
unrecoverable errors are usually parity errors. 


(Continued on next page) 
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Table 3-4 (Cont.) 
Disk Status Returns 


Coce Reason 


IE.WCK Write check error 


An error was detected during the write check 
portion of an operation. 


IE.WLK Write-locked device 


The task attempted to write on a disk that was 
write-locked. 


When a disk I/O error condition is detected, an error is usually not 
returned immediately. Instead, Micro/RSX attempts to recover from 
most errors by retrying the function as many as eight times. 
Unreccverable errors are generally parity, timing, or other errors 
caused by a hardware malfunction. 


3.5 POWER-FAIL RECOVERY 
For DUDRV devices, the power-fail recovery is handled by the driver. 


For DLDRV and DYDRV devices, a disk driver is called at its power-fail 
recovery entry point when a power-fail occurs. This recovery routine 
gives a disk sufficient time to spin back up and be ready to accept 
I/O requests. 


There are three possible recovery procedures: 


1. If a device is busy prior to the power-fail and the requested 
I/O has not completed, the routine times out and checks the 
device status until the device is ready for I/O operations to 
resume. 


2. If a device is not busy prior to the power-fail and receives 
an I/O request after the power-fail, the routine times out 
and checks the device status until the device is ready for 
I/O operations to resume. 


3. If a device is not busy prior to the power-fail and there are 
no pending I/O requests, operations resume with no special 
handling by the recovery routine. 

Note in the first two cases that, if the maximum time-out count is 


reached before the disk spins back up and is ready, an unsuccessful 
I/O completion code is returned. 


3.6 PROGRAMMING HINTS 
3.6.1 RLO2 Last Track Bad-Sector File 


The driver write-protects the last track of an RLO2 cartridge. This 
track contains the factory-recorded bad-sector file. 
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3.6.2 RX02 Media Characteristics 


The RX02 device driver (DYDRV) dynamically updates the system data 
base to reflect the characteristics of the media in the RX02 drive. 
Recommended Action: User tasks should issue a QIO Sense 
Characteristics function before requesting the device's media 
characteristics with the GLUNS macro. 


3.6.3 Stall I/O for RC25 Disks 


Because two RC25 disk units revolve on the same spindle and share’ the 
same head mechanics, you must spin down both units of a subsystem in 
order to spin down one unit. You cannot access either unit until the 
subsystem is spun up again. Because you must spin down the drive any 
time you want to insert or remove a disk from the removable-media 
unit, the device driver (DUDRV) allows you to spin down the subsystem 
and still retain context on the fixed-media unit, provided it is 
mounted as a Files-1l or foreign volume. It does this by postponing 
input and output to the fixed-media unit until the subsystem is spun 
up again and the heads are reloaded. This is called stalled I/O. 


When the driver receives an I/O request that it cannot process because 
the drive is spun down, it issues the following message to the 
console: 


<ddnn:> - I/O stalled 


When the drive is spun up again and I/0 to the device is resumed, the 
driver issues the following message to the console: 


<ddnn:> - I/O resumed 


Note that because the only reason you would want to spin down the disk 
on a running system would be to replace the removable disk, and you 
would never specifically need to spin down the fixed-media unit, I/0 
is never stalled to the removable-media unit. The removable-media 
unit behaves like any other disk on an RSX system: if you spin it 
down, context is lost. 


Stalling I/O to an RC25 subsystem affects the system's performance. 
If you initiate an operation requiring I/O to a stalled unit, you will 
not receive a timely response to the request. Although the I/0 
request is queued to the device driver, the driver ignores the request 
until the drive is loaded and the unit is’ ready. The driver then 
resumes processing requests. Note, however, that an operation can 
continue as long as it does not require access to the unit whose I/O 
is stalled. 


Sometimes an operation that does not involve stalled-I/O units is 
delayed as well. For example, assume that your system disk is in the 
fixed-media unit and that you spin down a subsystem in order to change 
the disk pack in the removable-media unit. If a user then initiates 
an operation requiring a task to be loaded from the fixed unit, the 
loader issues a queued I/O request to the fixed unit. However, the 
device driver does not respond to this request immediately, since the 
subsystem is spun down. Also, because the loader cannot service 
additional tasks until it loads the current task from the disk, load 
operations to other disks on the system remain in the loader's work 
queve until the current load operation completes. 
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NOTE 


Like the loader, the Files-ll Ancillary Control 
Processor (Files-11 ACP or FIllACP) is another 
single-threaded task that may delay response time when 
I/O is stalled to the RC25. To avoid this delay, you 
should always install a unique ACP for the RC25 
fixed-media units (see the MOUNT command in the 
RSX-11M-PLUS Command Language Manual). 


System users may find it difficult to distinguish between system 
crashes and system delays due to stalled I/0. Therefore, it is 
recommended that, before you spin down an RC25 subsystem, you inform 
all system users of your intentions. 


3.6.4 Dismounting the RC25 


You dismount a unit on the RC25 in the same way as for other disk 
devices, by using the DISMOUNT command. However, there are 
restrictions on using the /UNLOAD qualifier to spin down the disk. 
Since context may be lost on the removable disk if the subsystem is 
spun down, all spin down requests are ignored for the fixed unit of 
the RC25. For the removable disk unit, you must be privileged in 
order to spin down the device while dismounting it. The privileged 
Status of DISMOUNT/UNLOAD is a safety measure to control who is able 
to spin down the system disk. 


If you are a privileged user, DISMOUNT/UNLOAD issues the _ following 
message when the command executes properly: 


Warning -- All units of multiunit drive will spin down <ddnn:> 


If you are a nonprivileged user, DISMOUNT/UNLOAD refuses your request 
to spin down a unit and issues the following message: 


Warning -- Volume will not spin down <ddnn:> 


CHAPTER 4 


TAPE DRIVERS 


4.1 INTRODUCTION 


The Micro/RSX system has three tape drivers: the DDDRV.TSK for the 
TU58 tape subsystem, the MSDRV.TSK for the TSV05 and TK25 tape 
subsystems, and the MUDRV.TSK for the TK50 tape subsystem. 


4.2 MSDRV - TSV05/TK25 MAGNETIC TAPE 


The MSDRV driver processes I/O requests for the TSVO5/TK25 tape 
subsystem. 


The TSVO5 is a Q-bus device that reads and writes at 1600 bpi on a 
1/2-inch 9-track tape at 25 inches/second in TS11 compatibility mode. 
It is an integrated subsystem with a drive, a controller, and a 
formatter. The hardware is microprocessor controlled for all 
Operations, including I/O transfers, tape motion, and has 
comprehensive (internal) diagnostic test execution. Recording is 1600 
bpi phase-encoded (PE). 


The TK25 consists of a TKQ25 controller for the Q-bus and ae TK25 
streaming tape drive. The TK25 reads and writes data on a DC600A 
1/4-inch tape cartridge that is recorded at 8K bpi on 10 serial data 
tracks in a serial serpentine recording method. The TK25 has a 
storage capacity of 60 Mbytes for 8 Kbyte data records, and it has a 
maximum data transfer rate of 55 Kbytes per second. 


4.3 MUDRV - TK50 MAGNETIC TAPE 


The TK50 is an integrated subsystem that consists of a controller for 
the Q-bus and a TK50 streaming tape drive. The controller handles all 
error recovery and correction, and it holds multiple outstanding 
commands in internal buffers. The tape drive reads and writes data on 
a 1/2-inch tape cartridge that is recorded at 6667 bpi on serial data 
tracks in a serial serpentine recording (Modified Frequency 
Modulation) method. The tape speed is 75 inches per second and the 
storage capacity is approximately 100 Mbytes. 


4.4 GET LUN INFORMATION MACRO 


Word 2 of the buffer filled by the Get LUN Information macro (the 
first characteristics word) contains the following information for 
TSVO5/TK25 tape. A bit setting of 1 indicates that the described 
characteristic is true for magnetic tapes. 
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Bit Setting Meaning 


0 0 or l Record-oriented device (0 if the tape is 
mounted, 1 if it is not) 


1 0 Carriage-control device 

2 0 Terminal device 

3 0 File-structured device 

4 0 or l Single-directory device (0 if the tape is not 


mounted, 1 if it is) 


5 1 Sequential device 

6 l Mass storage device 

7 0 or l User-mode diagnostics supported 

8 1 22-bit direct addressing supported 

9 0 Unit software write-locked 

10 0 Input spooled device 

11 0 Output spooled device 

12 0 Pseudo-device 

13 0 Device mountable as a communications 
channel 

14 0 or l Device mountable as a Files-1l volume 

15 0 or l Device mountable 


Words 3 and 4 of the buffer are undefined; word 5 indicates 
default buffer size, for magnetic tapes 512 bytes. 


4.5 STANDARD QIOS$S FUNCTIONS 
Table 4-1 lists the standard functions of the QIO$ macro that 
valid for supported magnetic tape devices. 


Table 4-1 
Standard QIOS Functions for TSV05/TK25/TK50 


Format Function 
QIOSC IO.ATT,... Attach device 
QIOSC IO.DET,... Detach device 
QIOSC IO.KIL,... Cancel I/0 requests 
QIOSC IO.RLB,...,<stadd,size> Read logical block 


(read tape into buffer) 


the 


are 


(Continued on next page) 


TAPE DRIVERS 


Table 4-1 (Cont.) 
Standard QIOS Functions for TSV05/TK25/TK50 


Format Function 


QIOSC IO.RVB,...,<stadd,size> Read virtual block 
(read tape into buffer) 


QIOSC IO.WLB,...,<stadd,size> Write logical block 
(write buffer contents to tape) 


QIOSC IO.WVB,...,<stadd,size> Write virtual block 
(write buffer contents to tape) 


stadd The starting address of the data buffer. It must be on a 
word boundary for MUDRV devices, and it may be on a byte 
boundary for MSDRV devices. 

size The data buffer size in bytes. Size must be greater than 0, 
and, for a write, must be at least 14 bytes. For the 
TSVO5/TK25 or TK50, data transfers may be odd or even. 


IO.KIL terminates an I/O request that is in progress if any of the 
following occur: 


@ A select error (not applicable to TK50) 
@ Error recovery 
e Interrupt servicing 


@e Device timeout servicing 


4.6 DEVICE-SPECIFIC QIO$ FUNCTIONS 


Table 4-2 lists the device-specific functions of the QIOS macro. that 
are valid for the supported magnetic tape devices. Additional details 
on certain functions appear as follows. 


4.6.1 I10.RLV 


The data appears in the specified buffer in a fashion identical with 
IO.RLB or IO.RVB, as long as the data block has the same length as the 
buffer. 


4.6.2 I10.RWD 


IO.RWD completion for MUDRV devices means that the rewind has_ been 
initiated. For MSDRV devices, I0O.RWD completion means that rewind to 
BOT has been completed. Additional operations on that controller may 
then be queued by the driver until load point (BOT) is reached. 
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4.6.3 I0.RWU 


IO.RWU is normally used when operator intervention is required (for 
example, to load a new tape). The operator must turn the unit back on 
line manually before subsequent operations can proceed. 


Table 4-2 
Jevice-Specific QIOS Functions for Supported Tape Devices 


Format 


Function 


Data Security Erase (TK50 only) 


Write end-of-file mark (tape mark) 


Read logical block reverse 


Rewind and turn unit off line 
Sense tape characteristics 
Mount tape and set tape 
characteristics (unit must be 


ready, tape at load point.) 


Space blocks 


Set tape characteristics 


forward, 


Space past (positive if 


Size must be 
for a write, must be at least 14 


For MSDRV or MUDRV devices, data transfers may be 


It must be on a 


for MUDRV devices, and it may be on a byte 


QIOSC I0O.DSE,... 
QIOSc IO.EOF,... 
QIOSc IO.ERS,... Erase 
QIosc IO.RLV,...,<stadd,size> 
QIOS® IO.RWD,... Rewind unit 
QIOSc IO.RWU,... 
QIOSc IO.SEC,... 
QIoOSsce I0.SMO,...,<cb> 
QIosce IO.SPB,...,<nbs> 
QIOSC IO.SPF,...,<nes> Space files 
QIosc I0.STC,...,<cb> 
cb The characteristic bits to set. 
nbs The number of blocks to space past (positive if 
negative if reverse). 
nes The number of EOF marks’ to 
forward, negative if reverse). 
size The size of the stadd data buffer in bytes. 
greater than zero, and, 
bytes. 
odd or even. 
stadd The starting address of the data buffer. 
word boundary 
boundary for MSDRV devices. 
4.6.4 IO.ERS 


Erases tape to provide an extended interrecord gap. 
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4.6.5 I0.DSE 


Causes the TK50 to erase from the current position to end-of-tape and 
then rewind the tape to beginning-of-tape. 


4.6.6 I10.SEC 


This function returns the tape characteristics in the second I/0 
status word. The tape characteristic bits are defined as follows: 


Can Be Set by 


Bit Meaning when Set IO.SMO and I0.STC 
0 Reserved. 
1 Swap byte mode (read/write). X 
For TSV05/TK25 
2 Reserved 
3 Even parity (default is odd). X 
(Not selectable for the TSV0O5, TK25, 
TK50.) 
4 Tape is past EOT. 
5 Last tape command encountered 


EOF (unless last command was 
backspace). 


6 Writing is prohibited. X 


7 Writing with extended inter- X 
record gap is prohibited 
(that is, no recovery is attempted 
after write error). 


8 Select error on unit (not applicable 
to the TK50). 


9 Unit is rewinding. 

10 Tape is physically write-locked. 

11 1600 bpi density (for TSV0O5/TK25, bit 11=1) 
IO.SMO or I10.STC cannot modify bit ll. 

12 Reserved. 

13 Tape is at load point (BOT). 

14 Tape is at end-of-volume (EOV). 

15 Tape is past EOV (reserved for dri- 


ver; always 0 when read by user). 


4.6.7 I0.SMO 
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This function can be used as a combination of the sense (IO.SEC) and 


set (10.STC) tape characteristics functions. 


Unlike IO0.STC, however, 


the I0.SMO function requires that the unit be READY and the tape be at 


load fpoint 


(BOT). If either of these conditions is not met, the 


functicn returns an error status code of IE.FHE (refer to Table 4-3). 


The I0.SMO function should be used to set the characteristics of 


newly loaded 


tape. If the IE.FHE error code is returned, the tape 


drive is not on line and is not at BOT. 


4.7 STATUS RETURNS 


The error and status conditions listed in Table 4-3 are returned by 
the MSDRV and MUDRV driver. 


Code: 


IS.SUC 


IS.PND 


IE.ABO 


IE.BYT 


IE.DAA 


Table 4-3 
MSDRV/MUDRV Tape Status Returns 


Reason 


Successful completion 


The operation specified in the QIOS$ macro was 
completed successfully. The second word of the I/0 
status block can be examined to determine the 
number of bytes processed, if the operation 
involved reading or writing. This code is also 
returned if nbs equals 0 in an IO.SPB function or 
if nes equals 0 in an IO.SPF function. 


I/O request pending 


The operation specified in the QIO$ macro has not 
yet been completed. The I/O status block is filled 
with Os. 


Operation aborted 


The specified I/O operation was canceled by I0.KIL 
while in progress or while still in the I/0 queue. 


Byte-aligned buffer specified 


Byte alignment was specified for a buffer, while 
only word alignment is legal for the QIO. 
Alternatively, the length of a buffer is not an 
even number of bytes. 


Device already attached 


The physical device unit specified in an I0O.ATT 
function was already attached by the issuing task. 
This code indicates that the issuing task has 
already attached the desired physical device unit, 
not that the unit was attached by another task. 


(Continued on next page) 


TAPE DRIVERS 


Table 4-3 (Cont.) 
MSDRV/MUDRV Tape Status Returns 


Code Reason 


IE.DAO Data overrun 


On a read, a record exceeded the stated buffer 
size. The final portion of the buffer is checked 
for parity, but is not transfered to memory. 


IE.DNA Device not attached 


The physical device unit specified in an _ I0.DET 
function was not attached by the issuing task. 
This code has no bearing on the attachment status 
of other tasks. 


IE.DNR Device not ready 


The physical device unit specified in the QI0$ 
macro waS not ready to perform the desired I/0 
operation. This code is returned to indicate one 
of the following conditions: 


e A time-out occurred on the physical device unit 
(that is, an interrupt was lost). 


e The physical drive was not on-line. 
IE. EOF End-of-file was encountered. 
IE.EOT End-of-tape encountered. 


The end-of-tape (physical end of tape (EOT) marker) 
was encountered while the tape was moving in the 
forward direction for a write or write tape mark 
operation. The IE.EOT code is returned continually 
in the I/O status block until the EOT marker is 
passed in the reverse direction. IE.EOT is not 
returned on a read operation. 


A length of tape is provided past EOT to be used 
for writing data and markers, such as_ volume 
trailer labels. For MUDRV devices, this length of 
tape must not be less than the length required to 
store the aggregate of the following records: 


e Two device dependent "maximum recommended record 
length" records 


e Three 80-byte records 

e Three tape marks 

The IE.EOT code is returned continually in the I/0 
status block until the EOT marker is passed in the 


reverse direction. IE.EOT is not returned on a 
read operation. 


(Continued on next page) 
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Table 4-3 (Cont.) 
MSDRV/MUDRV Tape Status Returns 


Code Reason 
IE.EOV End-of-volume encountered (unlabeled tape) 
On a forward space function, the logical 


end-of-volume was encountered. An end-of-volume is 
two consecutive end-of-file marks (EOF), or a 
beginning-of-tape mark (BOT) followed by an EOF. 
The tape is normally left positioned between the 
two marks. 


IE. FHE Fatal hardware error 


Nonrecoverable hardware error: for example, 
Magnetic tape unit not ready and/or tape not at 
load point when IO.SMO is issued. 


IE.IFC Illegal function 


An invalid function (or subfunction bit) was 
specified in a magnetic tape I/O request. Refer 
also to Section 4.2.4.3. 


IE.OFL Device off line 


The physical device unit associated with the LUN 
specified in the QIOS macro was not on line. When 
the system was booted, a device check indicated 
that this physical device unit was not in the 
configuration. 


IE.SPC Illegal address space 


The buffer specified for a read or write request 
was partially or totally outside the address space 
of the issuing task. For magnetic tape, this code 
is also returned if a byte count of 0 was specified 
or if the user attempted to write a block that was 
less than 14 bytes long. 


IE.VER Unrecoverable error 


The operation could not be completed due to a data 
transfer error and unsuccessful error recovery 
attempts. 


IE.WLK Write-locked device 


The task attempted to write on a tape unit that was 
physically write-locked. Alternatively, tape 
characteristic bit 6 was set by the software to 
write-lock the unit logically. 


After processing a QIOS request, the magnetic tape driver returns two 
status words. The first word contains one of the I/O status codes 
listed in Table 4-3. 
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For successful QIO$ execution (IS.SUC) or read requests (IE.DAO), the 
second I/O status word may contain further information. The 
operations for which this is true, and the information returned, are 
shown in Table 4-4. For all other cases the contents of this word is 
undefined. 


Table 4-4 


Information Contained in the Second I/O Status Word 


I/O Function 


Information Returned 


Code IS.SUC IE.DAO 
IO.RLB Number of bytes Number of bytes 
transferred in tape record 
IO.RLV Number of bytes Number of bytes 
transferred in tape record 
IO0.RVB Number of bytes Number of bytes 
transferred in tape record 
I0.SEC Tape charac- 
teristics word 
I0.SPB Number of records 
spaced over 
I0.SPF Number of files 
spaced over 
IO0.WLB Number of bytes 
transferred 
IO.WVB Number of bytes 
transferred 


4.7.0.1 Select Recovery - If a request fails because the desired unit 
is off line, no drive has the desired unit number, or the drive has 
its power off, the following message is output on the operator's 
console: 


*** MSn: -- SELECT ERROR 


The unit number of the specified drive. 


The driver checks the unit for readiness and repeats the message every 
15 seconds until the requesting task is aborted or the unit is made 
available. In the latter case, the driver then proceeds with the 
request. 


MUDRV devices (TK50) do not issue select errors. If the drive is 
taken offline, the drive positions the tape at BOT. This condition is 
treated as tape position lost or powerfail. 
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4.8 RETRY PROCEDURES FOR READS AND WRITES 


For MUDRV devices (TK50), the controller handles all error correction 
and recovery. 


For MSDRV devices, if a write operation fails, the driver attempts the 
following error recovery procedure a predetermined number of times: 


1. Repositions the tape 
2. Erases the tape to create an extended interrecord gap 
3. Retries the write operation 


The requesting task can use I0.STC to prohibit writing with an 
extended interrecord gap. In this case, the tape is backspaced and 
the write is retried. 


For MSDRV devices, if a read operation fails, the driver rereads’ the 
block in error a predetermined number of times. 


4.9 POWER-FAIL RECOVERY FOR MSDRV/MUDRV TAPES 


If a power failure or loss of physical control of the tape occurs, 
tape position is lost. (Note that an initial system boot simulates a 
recovery from a power failure.) Additionally, on auto-load drives, the 
tape will be positioned at BOT when the unit is turned on line. 


To prevent accidental destruction of data currently on tape, the 
driver maintains a power-fail status indicator. When this indicator 
is set, the driver disallows any data transfer or tape motion commands 
until a successful rewind (IO0.RWD), rewind unload (IO.RWU), or mount 
and set characteristics (I0.SMO) function is issued. The successful 
completion of these functions clears the power-fail indicator and all 
tape motion functions are allowed to proceed. It is also possible to 
issue the set and sense characteristics functions (I0.STC and IO.SEC) 
while the power-fail indicator is set. These functions, however, will 
not clear the bit. 


All functions other than those just described are considered invalid 
and cause the return of the IE.IFC (invalid function) error code to 
the requesting task. In situations where a tape is currently a 
mounted volume, the tape should be dismounted and then remounted 
before use. In doing this, the rewind command will be issued, thereby 
clearing the power-fail indicator. 


4.10 PROGRAMMING HINTS 


This section contains information on important programming 
considerations relevant to users of the MSDRV or MUDRV driver 
described in this chapter. 


4.10.1 Block Size 


Each block must contain at least 14 bytes for a write and may contain 
a maximum of 65,534 bytes. However, tape usage is more efficient with 
a larger buffer. 
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4.10.2 Importance of Resetting Tape Characteristics 


A task that uses tape should always set the tape characteristics to 
the proper value before beginning I/O operations. The task cannot be 
certain in what state a previous task left these characteristics. It 
is also possible that an operator might have changed the magnetic tape 
unit selection. If the selection switch is changed, the new physical 
device unit may not correspond to the characteristics of the unit 
described by the respective unit control block. 


4.10.3 Aborting a Task 


If a task is aborted while waiting for a tape unit to be selected, the 
MSDRV driver recognizes this fact within one second. 


If you abort a task while it waits for a tape unit to complete a space 
operation, the MSDRV driver may allow spacing to the next tape mark. 


For MUDRV devices (TK50), if you abort a task while it waits for a 
magnetic tape unit to complete a space operation, the driver may have 
spaced some or all of the requested spacing operation. 


The MUDRV terminates the spacing function immediately, which leaves 
the tape at an indeterminate position. A rewind should be performed 
immediately with another spacing function to get to a known position 
on the tape. 


4.10.4 End-of-Volume Status (Unlabeled Tape) 


The MSDRV/MUDRV driver detects end-of-volume when it spaces over the 
second of two consecutive tape marks. The tape is left positioned 
between the two tape marks. 


The tape driver returns the IE.EOV status code only on_ space 
operations. IE.EOV is never returned by read operations. 


For the purpose of checking for end-of-volume, the driver treats 
beginning of tape (BOT) as a tape mark. Therefore, any forward space 
operation from BOT that immediately encounters a tape mark will return 
IE.EOV. 


If a space operation stops between two tape marks but does not space 
over the second one, the driver will return end-of-file rather than 
end-of-volume. Any subsequent space operation from this point that 
immediately spaces over the second tape mark will return 
end-of-volume. 


During IO.SPF operations, the driver considers all tape marks to be 
files except for BOT and for the second tape mark spaced over at the 
end of volume. 


Note that both IO.SPF and I0.SPB operations leave the tape positioned 
after the tape mark in the direction of travel. 


If you want to treat two consecutive tape marks as end-of-volume on 
read operations, your application must keep track of the tape marks. 
The magnetic tape driver does not support two consecutive tape marks 
as end-of-volume on read operations. 
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4.10.5 Resetting Tape Transport Status or VCK 


When the tape transport status changes (goes on line or off line), 
further I/0 operations are inhibited. A deliberate I/0 sequencing 
must occur to allow physical I/O to proceed. This sequencing is done 
by issuing a IO.RWD or IO.SMO QIOS or including /RW or /REW switches 
to command requests (such as DMP). 


4.10.6 Issuing QIOs 


Users issuing QIOs directly to MSDRV/MUDRV must be aware of the 
following: 


e Completion of an IO.RWD request occurs when the MS: device 
reaches BOT. 


@e Completion of an IO.RWD request occurs when the MU: device 
Starts the rewind. 


@e When the MS: or MU: device changes status from off-line to 
on-line or vice versa, the MS: or MU: device inhibits 
further physical I/O operations. After such a change, the 
user must issue IO.RWD or IO.SMO requests that succeed before 
I/O can proceed. 


e For the MS: or MU: device, read/write data transfer features 
are: 


- The data buffer starting address must be on ae word 
boundary. 


- The data transfer size may be an odd or even byte count. 
The minimum must be 14 bytes for a write operation. 


- For the MSDRV, you can swap odd and even data bytes by 
using the tape characteristic bit 1 of IO.SMO or I0.STC 
requests. When bit 1 is set to 0, no byte swap occurs; 
when it is set to 1, byte swap does occur. If you use byte 
swapping, it is recommended that the data buffer size be an 
even byte count. 


@e For MU: devices, issuing an IO.KIL terminates the in-progress 
I/O operations in reverse order. 


@e CAUTION -- The MU: device handles QIOS$ requests in a 
different manner than other devices do. Multiple requests are 
queued in the controller itself and, therefore, the physical 
end-of-tape may be reached before all requests are processed. 
Thus, with multiple QIOs it is possible to pull tape off the 
supply reel. 


It is recommended that QIOWS be used, or that the total size 
of queued records to be written is not longer than the ANSI 
standard for the tape trailer size. 


The physical end-of-tape for MUDRV (MU:) devices is defined as 
the end of usable recorded area, which is located in the tape 
trailer area. This area begins at the EOT marker and extends 
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through a length that depends on the tape format. This length 
must be long enough to store the aggregate of the following 
records: 


- Two device dependent "maximum recommended record length" 
records 


-~ Three 80-byte records 


- Three tape marks 


4.11 BLOCK SIZE ON TAPES MOUNTED /NOLABEL 


Under certain conditions, if a file is written to a tape, its block 
size will be even and one more than the value specified in the MOUNT 
command. These conditions where this occurs are as follows: 


@e The tape is mounted /NOLABEL 
e The MOUNT command specifies an odd record size 
@e The MOUNT command specifies an odd block size 


FCS adds the padding character, an octal 136 (*) circumflex, to 
odd-sized blocks due to a hardware restriction; some tape drives will 
not allow an odd number of bytes to be transferred to or from _ tape. 
Therefore, blocks of data are padded with the circumflex character so 
that blocks of data can be written to tape on any tape drive. 


4.12 DDDRV - TU58 CARTRIDGE TAPE 


The DDDRV driver processes I/O requests for the TU58 tape subsystem. 
The TU58 is a tabletop dual tape drive that takes 256 kilobyte 
cartridge tapes. This tape drive is connected to the Micro/RSX System 
through one of the asynchronous serial lines. 


All I/0 transfers (commands and data) occur by means of the serial 
line interface at serial transmission rates of 9600 bps. All read and 
write check operations are performed by the controller hardware using 
a 16-bit checksum. The controller performs up to eight attempts to 
read a block, as necessary, before aborting the read operation and 
returning a hard error; however, whenever more than one read attempt 
is required for a successful read, the driver is notified in order’ to 
report a soft error message to the error logger. 


4.12.1 Get LUN Information Macro 


Word 2 of the buffer filled by the Get LUN Information macro (the 
first characteristics word) contains the following information for the 
TU58. A bit setting of 1 indicates that the described characteristic 
is true for this device. 


Bit Setting Meaning 
0 0 Record-oriented device 
1 0 Carriage-control device 
2 0 Terminal device 
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Bit Setting Meaning 
3 1 File-structured device 
4 0 Single-directory device 
5 0 Sequential device 
6 1 Mass storage device 
7 1 User-mode diagnostics supported 
8 0 22-bit direct addressing supported 
9 0 Unit software write-locked 
m0) 0 Input spooled device 
at 0 Output spooled device 
12 0 Pseudo-device 
13 0 Device mountable as a communications channel 
14 1 Device mountable as a Files-1ll volume 
15 1 Device mountable 


Words 3 and 4 of the buffer are a double-precision number specifying 
the total number of blocks on the device; this value is 512(decimal) 
blocks. Word 5 indicates the default buffer size, which is 
512(decimal) bytes. 


4.12.2 Standard QIOS Functions 
Table 4-5 lists the standard QIOS macro functions of the QIOS macro 
that are valid for the TU58. 


Table 4-5 
Standard QIOS Functions for the TU58 


Format Function 
Q1OSC LOC ATT jess Attach device 
QIosc 10% DET -é0% Detach device 
Q10$SC IO.KIL,... Cancel I/0 
requestsl 
Q10$C IO.RLB,...,<Sstadd,size,,,lbn> Read logical block 
QIOSC IO.WLB,...,<stadd,size,,,lbn> Write logical block 


1. In-progress operations are allowed to complete when IO.KIL is 
received. I/O requests that are queued when I0O.KIL is 
received are killed. 
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stadd The starting address of the data buffer (must be on a_e word 
boundary). 


size The data buffer size in bytes (must be even and greater than 
0). For a write, the size must be at least 14 bytes. 


lbn The logical block number on the cartridge tape where the 
data transfer starts (must be in the range of 0-777). 


4.12.3 Device-Specific QIO$ Functions 
The device-specific QIO$ macro functions that are valid for the TU58 
are shown in Table 4-6. 


Table 4-6 
Device-Specific QIOS$ Functions for the TUS58 


Format Function 
QIOSC IO.WLC,...,<stadd,size,,,,lbn> Write logical block with 


check 


QIOSC IO.RLC,...,<stadd,size,,,,lbn> Read logical block with 


check 
QIosc I10.BLS!IQ.UMD,...,<lbn> Position tape 
QIOSC IO.DGN!IQ.UMD,... Run internal diagnostics 


stadd 


The starting address of the data buffer (must be on a word 
boundary). 


size 
The data buffer size in bytes (must be even and greater than 0). 


lbn 


The logical block number on the cartridge tape where the data 
transfer starts (must be in the range of 0-777). 


Additional details for device-specific QIO$ functions are provided in 
the following paragraphs. 


4.12.3.1 IO.WLC - The IO.WLC function writes the specified data onto 
the tape cartridge. A checksum verification is then performed by 
reading the data just written; data is not returned to the _ task 
issuing the function. An appropriate status, based on the checksum 
verification, is returned to the issuing task. 


4.12.3.2 I10.RLC - The IO.RLC function reads the tape with an 
increased threshold in the TU58's data recovery circuit. This is done 
as a check to insure data read reliability. 
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4.12.3.3 IO.BLS - The IO.BLS function is used for diagnostic purposes 
to position the tape to the specified logical block number. If you 
specify IO.BLS, you must use the IQ.UMD subfunction (see Chapter 1). 


4,.12.3.4 IO.DGN - The IO.DGN function is used for diagnostic purposes 
to execute the TU58's internal (firmware) diagnostics. Appropriate 
status information is returned to the issuing task by the I/0 status 
block. If you specify I0.DGN, you must use the IQ.UMD subfunction 
(see Chapter 1). 


4.12.4 Status Returns 
Table 4-7 lists the error and status conditions that are returned by 
the DDDRV driver for the TU58. 


Table 4-7 
TU58 Driver Status Returns 


Code Reason 


IS.SUC Successful completion 
The operation specified in the QIOS$ macro was completed 
successfully. The second word of the I/0 status block 
can be examined to determine the number of bytes 
processed, if the operation involved reading or writing. 
IE.DNR Device not ready 


The physical device unit specified in the QIOS macro was 
not ready to perform the desired I/O operation. 


IE.IFC Illegal function 


A function code was specified in an I/0 request that is 
invalid for the TU58. 


IE.FHE Fatal hardware error 
IE.TMO Time-out error 


The TU58 failed to respond to a function within the 
normal time specified by the driver. 


IE.VER Unrecoverable error 
After the system's standard number of retries (eight) 
had been attempted upon encountering an error, the 
operation still could not be successfully completed. 


IE.WLK Cartridge write-locked 


The task attempted to write on a tape cartridge that is 
physically write-locked. 
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4.13 PROGRAMMING HINTS 
4.13.1 Block Size on Tapes Mounted /NOLABEL 


Under certain conditions, if a file is written to a tape, its block 
Size will be even and one more than the value specified in the MOUNT 
command. This occurs under the following conditions: 


@® The tape is mounted /NOLABEL 
@ The mount command specifies an odd record size 
e The mount command specifies an odd block size 


FCS adds the padding character, an octal 136 (%) circumflex, 
odd-sized blocks due to a hardware restriction; some tape drives 
will not allow an odd number of bytes to be transferred to or from 
tape. Therefore, blocks of data are padded with the circumflex 
character so that blocks of data can be written to tape on any tape 
drive. 


CHAPTER 5 


LINE PRINTER DRIVER 


5.1 INTRODUCTION 


The Micro/RSX system line printer driver is LPDRV.TSK. LPDRV.TSK 
supports the following line printers: 


e LP25 Line Printer 


The LP25 is a band printer that has a 285 line per minute 
capacity. The LP25 has a standard 64-character set anda 
132-column format. 


e LP26 Line Printer 


The LP26 is a band printer capable of 600 lines per minute. 
The LP26 has a standard 64-character set and a 132-column 
format. 


e LNOl Laser Printer 


The LNO1l is a non-impact page printer that uses laser imaging 
combined with xerographic printing. This technology provides 
letter quality printing at line printer speeds with no noise. 
Printing is done on standard 8 1/2 inch by 11 inch paper at 12 
Pages per minute, which equates to 600 lines per minute. 
Contributing to the high print quality is a printer resolution 
of 300 by 300 dots per inch. The LNO1 offers the speed of a 
line printer with the advantages of a phototypeset device. 


5.2 GET LUN INFORMATION MACRO 


Word 2 of the buffer filled by the Get LUN Information macro (the 
first characteristics word) contains the following information for 
line printers. A bit setting of 1 indicates that the described 
characteristic is true for line printers. 


Bit Setting Meaning 
0 1 Record-oriented device 
1 1 Carriage-control device 
2 0 Terminal device 
3 0 File-structured device 
4 0 Single-directory device 
5 0 Sequential device 
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Bit Setting Meaning 
6 0 Mass-storage device 
?; 0 User-mode diagnostics supported 
8 0 22-bit direct addressing supported 
9 0 Unit software write-locked 
10 0 Input spooled device 
11 0 Output spooled device 
12 0 Pseudo device 
13 0 Device mountable as a communications 
channel 
14 0 Device mountable as a Files-1ll volume 
15 0 Device mountable 


Words 3 and 4 of the buffer are undefined; word 5 indicates’ the 
default size for the device, for line printers the width of the 
printer carriage (that is, 80 or 132). 


5.3 QI0O MACRO 
Table 5-1 lists the standard functions of the QIO macro that are valid 


for line printers. 


Table 5-1 
Standard QIO Functions for Line Printers 


Format | Function 

QIOSC IO.ATT,... Attach device 

QIOSC IO.DET,... Detach device 

QTosc IO.KIL,... Cancel I/0 requests 

QIOSC IO.WLB,...,<stadd,size,vfce> Write logical block 
(print buffer 
contents) 

QIOSC IO.WVB,...,<stadd,size,vfc> Write virtual block 
(print buffer 
contents) 

stadd The starting address of the data buffer (may be on a byte 


boundary). 


size The data buffer size in bytes (must be greater than 0). 
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vfc A vertical format control character from Table 5-3. 


IO.KIL does not cancel an in-progress request unless the line printer 
is in an off-line condition because of a power failure or a paper jam, 


or because it is out of paper. 


The line printer driver supports no device-specific functions. 


5.4 STATUS RETURNS 


Table 5-2 lists the error and status conditions that are 


the line printer driver described in this chapter. 


Table 5-2 
Line Printer Status Returns 


Code Reason 


IS.Suc Successful completion 


The operation specified in the 


returned by 


QIO macro was 


completed successfully. The second word of the 
I/O status block can be examined to determine the 


number of bytes processed, if 


involved writing. 


IS.PND I/O request pending 


The operation specified in the QIO macro 


operation 


has not 


yet been executed. The I/O status block is filled 


with Os. 

IE.ABO Operation aborted The specified I/O operation was 
canceled while in progress’ or while in the I/0 
queue. 

IE.DAA Device already attached 


The physical device unit specified 


an I0.ATT 


function was already attached by the issuing task. 


This code indicates that the issuing 


task has 


already attached the desired physical device unit, 
not that the unit was attached by another task. 


IE.DNA Device not attached 


The physical device unit specified that an I0.DET 
function was not attached by the issuing task. 
This code has no bearing on the attachment’ status 


of other tasks. 


IE.IFC Illegal function 


An I/O request specified a function code 


illegal for line printers. 


that is 


(Continued on next page) 
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Table 5-2 (Cont.) 
Line Printer Status Returns 


Cod2 Reason 


IE.OFL Device off line 
The physical device unit associated with the LUN 
specified in the QIO macro was not on line. When 
the system was booted, a device check indicated 
that this physical device unit was not in the 
configuration. 

IE.SPC Illegal address space 
The buffer specified for a write request was 
partially or totally outside the address space of 


the issuing task. Alternatively, a byte count of 
0 was specified. 


5.4.1 Ready Recovery 
If any of the following conditions occur: 
e Paper jam 
e Printer out of paper 
e Printer turned off line 
@e Power failure 


the driver determines that the line printer is off line, and _ the 
following message is output on the operator's console: 


***LPn: -- NOT READY 
where: 
n The unit number of the line printer that is not ready. 


The driver retries the function that encountered the error condition 
from the beginning, once every second. It displays the message every 
15 seconds until the line printer is readied. If a power failure 
occurs while printing a line, the entire line is reprinted from the 
beginning when power is restored. 


5.5 VERTICAL FORMAT CONTROL 


Table 3-3 summarizes the meaning of all characters used for vertical 
format control on the line printer. Any one of these characters can 
be specified as the vfc parameter in an IO.WLB or IO.WVB function. 
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Table 5-3 
Vertical Format Control Characters 


Octal 
Value Character Meaning 


040 Blank SINGLE SPACE: Output a line feed, print the 
contents of the buffer, and output a carriage 
return. Normally, printing immediately 
follows the previously printed line. 


060 Zero DOUBLE SPACE: Output two line feeds, print 
the contents of the buffer, and output a 
carriage return. Normally, the buffer 
contents are printed two lines below the 
previously printed line. 


061 One PAGE EJECT: Output a form feed, print the 
contents of the buffer, and output a carriage 
return. Normally, the contents of the buffer 
are printed on the first line of the next 


page. 


053 Plus OVERPRINT: Print the contents of the buffer 
and perform a carriage return, normally 
overprinting the previous line. 


044 Dollar PROMPTING OUTPUT: Output a line feed and 
sign then print the contents of the buffer. 


000 Null INTERNAL VERTICAL FORMAT : The buffer 
contents are printed without addition of 
vertical format control characters. In this 
mode, more than one line of guaranteed 
contiguous output can be printed per I/0 
request. 


All other vertical format control characters are interpreted as blanks 
(040 (octal)). 


5.6 PROGRAMMING HINTS 
This section contains information on important programming 


considerations relevant to users of the line printer driver described 
in this chapter. 


5.6.1 RUBOUT Character 


The line printer driver discards the ASCII character code 177 during 
output. 
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s 


5.6.2 Print Line Truncation 


If the number of characters to be printed exceeds the width of the 
print carriage, the driver discards excess characters until it 
receives one that instructs it to empty the buffer and return to 


horizontal position l. The user can determine that truncation will 
occur by issuing a Get LUN Information macro and examining word 5 of 
the information buffer. This word contains the width of the print 


carriage in bytes. 


5.6.3 Aborting a Task 


If a task is aborted while waiting for the line printer to be readied, 
the line printer driver recognizes this fact within one second. 


CHAPTER 6 


VIRTUAL TERMINAL DRIVER 


6.1 INTRODUCTION 


The virtual terminal driver supports offspring task use of virtual 
terminals in Micro/RSX systems. Virtual terminals are not physical 
hardware devices; they are actually implemented in software through 
the use of data structures created by the Micro/RSX Executive. 
Virtual terminals are created by the Executive when requested by 
parent tasks with the Create Virtual Terminal macro. Virtual 
terminals are useful in batch processing and other processing 
environments in providing noninteractive terminal I/0 support for 
offspring tasks, eliminating the need for operator intervention. 


Offspring task(s) "spawned" by or "connected" to the parent task that 
created the virtual terminal can perform terminal I/O operations with 
the virtual terminal in the same manner as with physical terminals. 
Virtual terminals differ from physical terminals in that they receive 
input from or output to a program (the parent task), rather than from 
a keyboard or to a display (or printer), respectively. 


6.2 GET LUN INFORMATION MACRO 


Word 2 of the buffer filled by the Get LUN Information macro (the 
first characteristics word) contains the following information for 
virtual terminals. A setting of 1 indicates that the described 
characteristic is true for virtual terminals. 


Bit Setting Meaning 
0 1 Record-oriented device 
l 1 Carriage-control device 
2 1 Terminal device 
3 0 File-structured device 
4 0 Single-directory device 
5 0 Sequential device 
6 0 Reserved 
7 0 User-mode diagnostics supported 
8 0 Massbus device 
9 0 Unit software write-locked 
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Bit Setting Meaning 
10 0 Input spooled device 
11 0 Output spooled device 
12 0 Pseudo device 
13 0 Device mountable as a communications channel 
14 0 Device mountable as a FILES-11 volume 
15 0 Device mountable 


Words 3 and 4 are undefined. Word 5 specifies the maximum byte count 
(that is, maximum buffer size) to which offspring requests will be 
truncated; this value is specified by the parent task in the Create 
Virtual Terminal system directive, as described in the RSX-11M/M-PLUS 
and Micro/RSX Executive Reference Manual. 


6.3 QIO MACRO 


Table 6-1 lists the standard and device-specific functions of the QIO 
macro that are valid for virtual terminals. 


‘Table 6-1 
Standard and Device-Specific QIO Functions for Virtual Terminals 


Format Function 


STANDARD FUNCTIONS: 


QIOSC IO.ATT,... . Attach device 
QIOSC IO.DET,... Detach device 
QIOSC IO.KIL,... Cancel I/O request 
QIOSC IO.RLB,...,<stadd,size> Read logical block 
QIOSC IO.RVB,...,<stadd,size> Read virtual block 


(effects IO.RLB) 
QIOSC IO.WLB,...,<stadd,size,stat> Write logical block 


QIOSC IO.WVB,...,<stadd,size,stat> Write virtual block 
(effects IO.WLB) 


DEVICE-SPECIFIC FUNCTIONS: 

QIOSC I0.STC,...,<cb,sw2,swl> Set terminal characteristics 
(enable/disable intermediate 
I/O buffering, or return I/0 
completion status to 
offspring task) 


QIOSC SF.GMC,...,<Stadd,size> Get multiple characteristics 


(Continued on next page) 
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Table 6-1 (Cont.) 


Standard and Device-Specific QIO Functions for Virtual Terminals 


Format . Function 


QIOSC I10.GTS,...,<stadd,size> Get terminal support 


QIOSC IO.RPR,...,<stadd,size,[tmo], Read logical block 


pradd,prsize,vfc> after prompt 


QIOSC SF.SMC,...,<stadd,size> Set multiple characteristics 


size 


stadd 


stat 


cb 


swl 


tmo 
vfc 


pradd 


prsize 


The size of the data buffer in bytes (must be greater than 
0). The buffer must be located within the addressing space 
of the parent or offspring task issuing the I/O request. 


The starting address of the data buffer. The address must 
be word aligned for SF.GMC, I0.GTS, and SF.SMC; otherwise, 
it may be aligned on a byte boundary. 


The I/O completion status code, specified by the parent 
task, that is issued by the virtual terminal driver in 
response to an offspring task's read request upon successful 
completion. 


Characteristic bits to become set, selecting the following 
virtual terminal functions: 


cb Value Bits Set Function 


0 none Enable intermediate 
buffering in the Executive 
pool 


1 0 Return the specified 
virtual terminal I/O 
completion status to the 
requesting offspring task 


2 1 Disable intermediate 
buffering 


3 0 and 1 Return status for 
offspring write request 


The 1/0 completion code for I/O completion status. 


NOTE 


The sw2 and swl parameters are valid in the I10.STC 
function only when cb=1 or cb=3. 


An optional time-out count (see following). 

A character for vertical format control. 

The starting address of the prompt buffer. 

The size of the prompt buffer in bytes. The buffer must be 


located within the address space of the offspring task 
issuing the I/O request. 


6-3 
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6.3.1 Standard QIO Functions 


6.3.1.1 IO.ATT - This I/O function can be issued by offspring tasks 
to attach the virtual terminal. (It is illegal for parent tasks to 
issue IO.ATT). Attaching a virtual terminal prevents other offspring 
tasks from executing I/0 operations with the virtual terminal. 
However, parent task I/O requests are always serviced when issued. 


6.3.1.2 I0.DET - This I/O function can be issued by offspring tasks 
to detach the virtual terminal, making it available for use by other 
offspring tasks connected to the same parent task. (It is illegal for 
parent tasks to issue IO.DET.) 


6.3.1.3 IO.KIL - Parent and offspring tasks can issue I0O.KIL to 
cancel I/O requests. An offspring task issuing IO.KIL can result in 
IE.ABO being returned to the parent task. 


6.3.1.4 I10.RLB, I0O.RVB, IO.WLB, I0O.WVB - These read and write 
functions execute requested I/O operations with virtual terminals in 
the same manner as with terminals described in Chapter 2, except as 
follows: 


1. The virtual terminal driver returns the tmo parameter of an 
offspring task's IO.RLB or I0.RVB' request, or the vfce 
parameter of an offspring task's IO.WLB or IO.WVB request as 
a stack parameter on entry to the appropriate AST for the 
parent task. 


2. The virtual terminal driver returns I/O completion status to 
the offspring task in response to successful completion of 
the offspring task's IO.RLB or IO.RVB request; however, the 
actual I/O completion status values returned are specified 
for data transfers in the third parameter word of the parent 
task's IO.WLB or IO.WVB response, or in the second and third 
parameters of the parent task's I0.STC function response when 
no data transfer is desired. 


6.3.2 Device-Specific QIO Function (I0.STC) 


The I0.STC function can be issued by parent tasks to enable/disable 
offspring task I/0 buffering in secondary pool, or _ to force an 
appropriate I/O completion status for an offspring task read I/0 
request when no data transfer is desired. Both of these applications 
for the I0.STC function are described as follows. 


Parent tasks can use I0.STC to enable (or disable) intermediate 
buffering in secondary pool. Intermediate buffering, when enabled, is 
performed on offspring task virtual terminal read and write requests 
when the offspring task is checkpointable. 


Thus, offspring tasks can be stopped for virtual terminal I/O and 
checkpointed in a manner similar to that when physical terminals are 
used. Whenever the virtual terminal driver determines that 
intermediate buffering should not be used, offspring tasks that issue 
terminal requests become locked in memory until I/0 completion; 
transfers occur directly between parent task and offspring task 
buffers without intermediate buffering in secondary pool. 
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In addition to the conditions that permit intermediate buffering (when 
specified), one condition can automatically disable intermediate 
buffering of the parent task. If the buffer size specified in the 
Create Virtual Terminal directive exceeds the maximum size specified 
at system generation time (512(decimal) maximum) , intermediate 
buffering is disabled. 


The second application for I0.STC is to allow the virtual terminal 
driver to return an appropriate I/O completion status in response to 
an offspring task read request. I/0 status returned in this manner 
allows successful completion of the offspring task's request when the 
parent task determines that no data transfer is desired; this 
condition can occur, for example, when no data is available for input 
to the offspring task by the virtual terminal driver. When used in 
this manner, the I0.STC function must include three parameters, 
<cb,sw2,swl>, as follows: 


Parameter Meaning 


cb A value of 1 is specified to indicate that the I/0 
completion status return to the offspring task is desired. 


NOTE 


If the virtual terminal is operating in full duplex 
mode, a cb value of 1 returns status for an 
offspring read request, and a cb value of 3. returns 
Status for an offspring write request. 


sw2 This parameter is the second word returned in the I/0 
completion status indicating the number of bytes read upon 
successful completion of an offspring task's read request. 
However, since no data transfer actually occurs, the value 
specified is 0; the byte count of 0 specified in this 
function is legal (and desired), whereas a byte count of 0 
in write operations is illegal (and will result in an error 
being returned to the parent task). 


swl This parameter specifies the status code to be returned to 
the offspring task by the virtual terminal driver in the 
first word of the I/O completion status. This value is 
returned in the high byte and a value of +1 is returned in 
the low byte of the status word. Typical values and_ the 
status that each represent are listed as follows: 


Code Value Completion Status Indicated 

IS.SUC + 1 Successful completion 

IS.CR 15 Read terminated by carriage 
return 

IS.ESC 33 Read terminated by an Altmode 

IS.ESQ 233 Read terminated by an escape 
sequence 
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6.3.3 SF.GMC 


The Get Multiple Characteristics function returns information on 
terminal characteristics. This function can be issued by both the 
parent and the offspring tasks. The virtual terminal driver returns 
the characteristics that were set by the previous corresponding SF.SMC 
request. However, only the full duplex mode (TC.FDX) characteristic 
affects the operation of the virtual terminal driver. The SF.GMC 
function is provided only to maintain transparency to the offspring 
task. 


Valid virtual terminal characteristics are listed in Table 6-2. 


6.3.4 I10.GTS 


The Get Terminal Support function returns a 4-word buffer of 
information specifying which features are a part of the virtual 
terminal driver. The virtual terminal driver provides the I0.GTS 
function only to maintain transparency to the offspring task. Table 
2-5 lists the options returned by the full duplex terminal driver. Of 
those listed, the virtual terminal. driver returns the following: 


Word 1 -- F1.BUF, F1.RPR, F1.UTB, and F1.VBF 


Word 2 -- F2.SCH and F2.GCH 


6.3.5 IO.RPR 


The Read After Prompt (IO.RPR) function can be issued only by the 
offspring task. When the offspring task issues this function, the 
function appears to the parent task as a separate write request 
followed by a read request. 


6.3.6 SF.SMC 


The SF.SMC function allows a task to set and reset the characteristics 
of a terminal. Both the parent and the offspring tasks may issue this 
function. The parent task may set virtual terminals to full duplex 
operation by using the SF.SMC function with the characteristics bit 
TC.FDX. When in full duplex mode, the virtual terminal driver 
attempts to process the offspring task's read and write requests 
simultaneously. In order to insure that these operations are 
overlapped, the parent task should minimize the amount of time it 
spends in AST state. 


The virtual terminal driver defaults to half duplex mode. 


Table 6-2 lists the characteristics that either the parent or _ the 
offspring task may set. 
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Table 6-2 
Virtual Terminal Characteristics 


Bit Name Octal Meaning (If Asserted) Default Value 
Value 
TC.FDX 64 Full duplex mode 0 
TC.SCP 12 Terminal is a scope 0 
TC.SMR 25 Uppercase conversion 0 
disabled 
TC.TTP 10 Terminal type 0 


6.4 STATUS RETURNS 


The error and status conditions listed in Tables 6-3 and 6-4 are 
returned by the virtual terminal driver described in this chapter. 

The SE.NIH error is returned by the SF.GMC and SF.SMC functions. For 
this error, the low byte of the first word in the I/O status block 

contains IE.ABO. The second word in the I/O status block contains an 

haha (starting at 0) pointing to the erroneous byte in the stadd 
uffer. 


Table 6-3 
Virtual Terminal Status Returns for Offspring Task Requests 


Code Reason 


-— Successful completion of an offspring task read 
request results in an I/O completion status specified 
in a parent task QIO parameter being returned. 
Typically, the status information returned simulates 
a subset of I/O returns normally produced by the 
terminal drivers described in Chapter 2. 


IS.SUC Successful completion 


The operation specified in the QIO- macro was 
completed successfully. The second word of the I/0 
status block indicates the number of bytes 
transferred on a write operation. 


IE. IFC Invalid function code 


The offspring task attempted a read or ae write 
function and the parent task did not specify an AST 
address in its response to the requested I/O 
function, or the offspring task issued an IO.STC or 
other invalid function. 


IE.ABO Request terminated 
The offspring task issued IO.KIL or the parent’ task 


eliminated the virtual terminal unit. 


(Continued on next page) 
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Table 6-3 (Cont.) 
Virtual Terminal Status Returns for Offspring Task Requests 


Code Reason 


IE.SPC Illegal address space 


Part or all of the buffer specified for a read or 
write request was outside of the task's address 
space, or a byte count of 0 was specified. 


IE.UPN Insufficient dynamic storage 


The driver could not allocate an AST block to notify 
the parent task of an offspring task request, or the 
driver could not allocate an intermediate buffer in 
the Executive pool. 


SE.NIH A terminal characteristic other than those in Table 
6-2 was specified, or an offspring task attempted to 
assert TC.FDX. 


Table 6-4 
Virtual Terminal Status Returns for Parent Task Requests 


Code Reason 

IS.SUC Successful completion 
The operation specified in the QIO macro was 
completed successfully. The second word of the I/0 
status’ block indicates the number of bytes 


transferred on a read or write operation. 
IE.EOF End of file encountered 
The I0.STC function was completed successfully. 
IE.BAD Bad parameters 
The parent task specified a buffer size that exceeded 
the system maximum specified at system generation 
time. 
IE.DUN Device not attachable 
An are or IO.DET function was issued by the parent 
task. 


(Continued on next page) 


Virtual 


Code 


IE.1IFC 


SE.NIH 
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Table 6-4 (Cont.) 
Terminal Status Returns for Parent Task Requests 


Reason 


Invalid function code 


A read, write, or IO.STC function was issued without 
a pending offspring task request. This status can 
occur if the offspring task cancels a pending read or 
write request. This function code is also returned 
when I0.STC is’ issued to enable intermediate 
buffering on a virtual terminal unit whose buffer 
size, specified in the Create Virtual Terminal 
directive, exceeds the system maximum specified at 
system generation time. 


A terminal characteristic other than those in Table 
6-2 was specified in an SF.GMC or SF.SMC request. 


CHAPTER 7 


NULL DEVICE DRIVER 


Micro/RSX provides a driver for a software construct called the "null 
device." The mnemonic for the null device is NL:, and its 
characteristics are as follows: 


@e A read from NL: returns an end-of-file error (IE.EOF). 

e A write to NL: immediately returns success (IS.SUC). 
The null device functions as a "wastebasket" to which you can direct 
output, and from which it will never return. It is particularly 
useful when used in conjunction with an indirect command file and MCR 
ASN commands, as in the example following. 
Figure 7-1 shows the contents of a Task Builder command file called 
TESTBLD.CMD. Symbolic device names are used for the output file, map 
file, and input file. These names may be reassigned at task-build 
time. In particular, in the example following, the map file is 
assigned to the null device and thus is thrown away. 

>ASN SY:=0U: 

>ASN NL: =MP: 

>ASN DK1:=IN: 


>TKB @TESTBLD 


OU: TEST,MP:TEST=IN:{200,220]TEST 
/ 


ASG=TI:2 
// 


ZK-4085-85 


Figure 7-1 Indirect TKB Command File TESTBLD.CMD. 
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SUMMARY OF I/O FUNCTIONS 


This appendix summarizes valid I/O functions for all device drivers 
described in this manual. Both devices and functions are listed 
alphabetically. The meanings of the five parameters represented by 
the ellipsis (...) are described in Section 1.5.1. The meanings of 
the function-specific parameters shown below are discussed in the 
appropriate driver chapters. The user may reference these functions 
symbolically by invoking the system macros FILIO$ (standard I/0 
functions) and SPCIOS (special I/O functions), or by allowing them to 
be defined at task-build time from the system object library. 


A.1 TU58 DRIVER 


IO.ATT... Attach device 

LOVDET)..%.4 Detach device 

TO. Gy ss Cancel I/O requests 
IO.RLB,...,<stadd,size,,,lbn> Read logical block 
IO.WLB,...,<stadd,size,,,lbn> Write logical block 
IO.WLC,...,<stadd,size,,,lbn> Write logical block with check 
IO.RLC,...,<stadd,size,,,lbn> Read logical block with check 
IO.BLS,...,<lbn> Position tape 

IO.DGN,... Run internal diagnostics 


A.2 DISK DRIVER 
IO.RLB,...,<stadd,size,,blkh,blkl> Read logical block 
IO.RPB,...,<stadd,size,,,pbn> Read physical block 


IO.RVB,...,<stadd,size,,blkh,blkl> Read virtual block 


I0.SEC,...,<stadd,size,pbn> Sense characteristics (RX02) only 
IO.SMD,...,<density,,> Set media density (RX02 only) 
IO.WDD,...,<stadd,size,,,pbn> Write physical block (with 


deleted data mark - RX02 only) 
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IO.WLB,...,<stadd,size,,blkh,blkl> 


IO.WLC,...,<stadd,size,,blkh,blkl> 


IO.WPB,...,<stadd,size,,,pbn> 


IO.WVB,...,<Sstadd,size,,blkh,blkl> 


A.3 LINE PRINTER DRIVER 
LO. ATT) 80 

IO.DET,... 

IO.KIL,... 
IO.WLB,...,<stadd,size,vfc> 


IO.WVB,...,<Stadd,size,vfc> 


A.4 MAGNETIC TAPE DRIVER 
IO.ATT,... 

IO.DET,... 

IO.DSE,... 

IO.EOF,... 

IO.KIL,... 
IO.RLB,...,<Sstadd,size> 
IO.RLV,...,<Sstadd,size> 
IO.RVB,...,<stadd,size> 
IO.RWD,... 

IO.RWU,... 

IO.SEC,... 
I0.SMO,...,<cb> 
IO.SPB,...,<nbs> 
IO.SPF,...,<nes> 
I0.STC,...,<cb> 
IO.WLB,...,<Stadd,size> 


IO.WVB,...,<stadd,size> 


Write logical block 


Write logical block followed 
by write check 


Write physical block 


Write virtual block 


Attach device 
Detach device 
Cancel I/O requests 
Write logical block 


Write virtual block 


Attach device 

Detach device 

Data security erase (TK50 only) 
Write end-of-file (tape mark) 
Cancel I/O requests 

Read logical block 

Read logical block reverse 
Read virtual block 

Rewind tape 

Rewind and turn unit off line 
Read tape characteristics 
Mount tape and set tape characteristics 
Space blocks 

Space files 

Set tape characteristics 

Write logical block 


Write virtual block 


SUMMARY OF I/O FUNCTIONS 


A.5 TERMINAL DRIVER 


IO.ATA,...,<ast, [parameter2] 
, [ast2]> 


LOVATT y.68:6 
I0.CCO,...,<stadd,size,vfc> 


IO.DET,... 


ATTACH device, specify unsolicited- 
character ASTl 


Attach device 
Write logical block, cancel CTRL/O 


Detach device 


IO.EIO! TF.RLB,...,<stadd,size> Extended I/O Read Functions 2 


IO.EIO!TF.WLB,...,<stadd,size> Extended I/0 Write Functions 


I10.GTS,...,<stadd,size> 
IO.HNG, eee 
IO.KIL,... 


IO.RAL,...,<stadd,size, [tmo] > 


IO.RLB,...,<Sstadd,size, [tmo] > 
IO.RNE,...,<stadd,size, [tmo] > 


IO.RPR,...,<Stadd,size,[tmo], 
pradd,prsize,vfc> 


IO.RST,...,<stadd,size, [tmo] > 


IO.RTT,...,<Sstadd,size,([tmo], 
table> 


IO.RVB,...,<stadd,size, [tmo] > 


IO.WAL,...,<Sstadd,size,vfc> 


IO.WBT,...,<stadd,size,vfc> 


IO.WLB,...,<stadd,size,vfc> 
IO.WVB,...,<stadd,size,vfc> 
SF.GMC,...,<stadd,size> 


SF.SMC,...,<stadd,size> 


Subfunction bits for terminal- 


Get terminal support 
Hangup remote line 
Cancel I/O requests 


Read logical block and pass all 
charactersl 


Read logical block}! 
Read logical block and do not echol 


Read after promptl 


Read with special terminators 


Read logical block _ended by specified 
special terminator 


Read virtual block! 


Write logical block and pass all 
characters 


Write logical block and break through 
any ongoing I/0 


Write logical block 
Write virtual block 
Get multiple characteristics 


Set multiple characteristics 


driver functions: 


TF.AST Unsolicited-input-character AST 
TF.BIN Binary prompt 

TE .CCO Cancel CTRL/O 

TF .ESQ Recognize escape sequences 

TF .NOT Unsolicited input AST notification! 
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TF.RAL Read, pass all characters 

TF .RCU Restore cursor position! 

TF .RDI Read with default input (I0.EIO function only)? 

TF.RES Read with escape sequence processsing enabled (I0O.EIO 
function only)2 

TF.RLB Read logical block (IO.EIO function only)? 

TF.RLU Read and convert from lower- to upper-case (I0.EIO 


function only)2 


TF.RNE Read with no echo 

TF .RNF Read with no filter (I0.EIO function only) 

TF.RPR Read after prompt (IO.EIO function only)? 

TF.RPT Read in pass-through mode (IO.EIO function only)? 

TE.RST Read with special terminators 

TF .RTT Read with specified special terminator table (IO.EIO 
function only) 

TF .TMO Read with time-out! 

TF .WAL Write, pass all bits 

TF. .WBT Break-through write 

TF.WIR Write with input redisplayed 

TE .xCC CTRL/C starts a command line interpreter! 

TF .XOF Send XOFF 


1. "ast2", "“parameter2", and “tmo" parameters are available for 
full-duplex driver functions only. 


2. Full-duplex driver only. 


A.6 VIRTUAL TERMINAL DRIVER 


LOVATT 5 600 Attach device 
IO.DET,..-. Detach device 
IO.KIL,... Cancel I/O request 
IO.RLB,...,<stadd,size> Read logical block 
IO.RVB,...,<stadd,size> Read virtual block 


IO.WLB,...,<stadd,size,stat> Write logical block 
IO.WVB,...,<stadd,size,stat> Write virtual block 
IO.STC,...,<cb,sw2,swl> Set terminal characteristics (enable/ 


disable intermediate buffering, or 
return I/O completion status) 


APPENDIX B 


I/O FUNCTION AND STATUS CODES 


This appendix lists the numeric codes for all I/O functions, directive 
status returns, and I/0 completion status’ returns. Lists are 
organized in the following sequence: 

e 1/0 completion status codes 

e Directive status codes 

e Device-independent I/0 function codes 


e Device-dependent I/O function codes 


Device-dependent function codes are listed by device. Both devices 
and codes are organized in alphabetical order. 


For each code, the symbolic name is listed in form IO.xxx, IE.xxx, or 
IS.xxx. A brief description of the error or function is also 
included. Both decimal and octal values are provided for all codes. 


B.1 I/O STATUS CODES 


This section lists error and success codes which can be returned in 
the I/0 status block on completion of an I/O function. The codes 
below may be referenced symbolically by invoking the system macro 
IOERRS,. 


B.1.1 I/O Status Error Codes 


Name Decimal Octal Meaning 

IE. 2DV -48 177720. —- Rename--two different devices 
IE.ABO -15 177761 ; Operation aborted 

IE.ALC ~84 177654 Allocation failure 

IE. ALN -34 177736 File already open 

IE.BAD -01 177777 Bad parameter 

IE.BBE -56 177710 Bad block on device 

IE.BCC -66 177676 Block check error or framing error 


Name 
IE.BDI 
IE.BDR 
IE.BDV 
IE BHD 
IE.BLB 


IE.BLK 


IE.BNM 
IE.BTF 
IE.BTP 
TE.BVR 


IE.BYT 


IE.CKS 
ITE.CLO 
IE.CNR 
IE.CON 
IE.DAA 
ITE.DAO 
IE.DFU 
IE.DIS 
IE.DNA 
IE.DNR 
IE.DSQ 
IE.DUN 


IE.DUP 


IE.EOF 
IE.EOT 
IE. EOV 
IE.EXP 


IE.FEX 


Decimal 
-52 
-50 
-55 
-64 
-70 


-20 


-54 
-76 
-43 
-63 


-19 


~30 
-38 
-96 
-22 
-08 
-13 
-24 


-69 


-62 
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Octal 

177714 
177716 
177711 
177700 
177672 
177754 


177712 
177664 
177725 
177701 


177755 


177742 
177732 
177640 
177752 
177770 
177763 
177750 
177673 
177771 
177775 
177646 
177767 


177707 


177766 
177702 
177765 
177665 


177717 


Meaning 
Bad directory syntax 
Bad directory file 
Bad device name 
Bad file header 
Bad logical buffer 


Invalid block number 
Logical block number too large 


Bad file name 

Bad tape format 
Bad record type 
Bad version number 


Odd byte count (or virtual address) 
Byte-aligned buffer specified 


File header checksum failure 
File was not properly closed 
Connection rejected 

UDC connect error 

Device already attached 

Data overrun 

Device full 

Path lost to partner 

Device not attached 

Device not ready 

Disk quota exceeded 

Device not attachable 


Enter--duplicate entry in 
directory 


End-of-file encountered 
End-of-tape encountered 
End-of-volume encountered 

File expiration date not reached 


Rename--a new file name already 
in use 


Name 
IE.FHE 
IE.FLG 
IE.FLN 
IE.FOP 
IE.HFU 
IE.ICE 
IE.IES 
IE.IFC 
IE.1IFU 


IE.ILL 


IE.IQU 
IE.ISQ 
IE.LCK 
IE.MII 
IE.MOD 
IE.NBF 


IE.NBK 


IE.NDA 
IE.NDR 
IE.NFI 
IE.NFW 


IE.NLK 


ITE.NLN 
IE.NNC 
IE.NNN 
IE.NNT 


IE.NOD 


IE.NSF 


IE.NST 


Decimal 
-59 
-89 
-81 
-53 
-28 
-47 
-82 
-02 
-25 


-42 


-91 
-61 
-27 
-99 
-21 
-39 


-41 


-78 
-72 
-60 
-69 


-79 


-37 
-77 
-68 
-94 


-23 


-26 


-80 


Octal 

177705 
177647 
177657 
177713 
177728 
177721 
177656 
177776 
177747 


177726 


177645 
177703 
177745 
177635 
177753 
177731 
177727 


177662 
177670 
177704 
177673 


177661 


177733 
177663 
177674 
177642 


177751 


177746 


177660 
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Meaning 
Fatal hardware error 
Event flag already specified 
Device already offline 
File already open 
File header full 
Internal consistency error 
Invalid escape sequence 
Invalid function code 
Index file full 


Invalid operation on file 
descriptor block 


Inconsistent qualifier usage 

Invalid sequential operation 

Locked from read/write access 
Media inserted incorrectly 


Invalid UDC or ICS/ICR module 


No buffer space available for file 


File exceeds space allocated, 
no blocks 


No data available 

No dynamic space available 
File ID was not specified 
Path lost to partner 


Task not linked to specified 
ICS/ICR interrupts 


No file accessed on LUN 

Not ANSI "D" format byte count 
No such node 

Not a network task 


Caller's nodes exhausted 
No dynamic memory available 


No such file 


Specified task not installed 


Name 
IE.NRJ 
IE.NTR 
IE.OFL 
IE.ONL 
IE.ONP 
IE.OVR 
IE.PES 
IE.PRI 
IE.RAC 
IE.RAT 
IE.RBG 
IE.RCN 
IE.REJ 
IE.RER 
IE.RES 
IE.RNM 
IE.RSU 
IE.SNC 
IE.SPC 
IE.SPI 
IE.SQC 
IE.SRE 


IE.STK 


IE.SZE 
IE.TML 
IE.TMO 
IE.UKN 
IE.ULK 
IE.URJ 
IE.VER 


IE.WAC 


Decimal 


-74 
-87 
-65 
~67 
-05 
-18 
-83 
-16 
-44 
-45 
-40 
-46 
-88 
-32 
-92 
-51 
a7 
-35 
-06 
-100 
-36 
=4 
-58 


-98 
-93 
-95 
-97 
-85 
-73 
-04 


-29 


I/O FUNCTION AND STATUS CODES 


Octal 

177666 
177651 
177677 
177675 
177773 
177756 
177655 
177760 
177724 
177723 
177730 
177722 
177650 
177740 
177644 
177715 
177757 
177735 
177772 
177634 
177734 
177762 


177706 


177636 
177643 
077641 
177637 
177653 
177667 
177774 


177743 


Meaning 
Network connection reject 
Task not triggered 
Device off line 
Device on line 
Hardware option not present 
Invalid read overlay request 
Partial escape sequence 
Privilege violation 
Invalid record access bits set 
Invalid record attribute bits set 
Invalid record size 
Invalid record number--too large 
Transfer rejected by receiving CPU 
File processor device read error 
Circuit reset during operation 
Cannot rename old file system 
Sharable resource in use 
File ID, file number check 
Invalid user buffer 
Spindown ignored 
File ID, sequence number check 
Send/receive failure 


Not enough stack space 
(FCS or FCP) 


Unable to size device 

Too many links to task 
Time-out on request 

Unknown name 

Unlock error 

Connection rejected by user 
Parity error on device 


Accessed for write 


B-4 
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Meaning 


Atribute control list format 
error 


Write check error 
File processor device write error 


Write-locked device 


Name Decimal Octal 
IE.WAT -31 177741 
IE.WCK -86 177652 
IE.WER -33 177737 
IE.WLK -12 177764 
B.1.2 I/0 Status Success Codes 

Decimal Octal 

Name Bytes Word 

IS.CR Byte 0: 1 006401 
Byte l: 15 

IS.CC Byte 0: 1 001401 
Byte l: 3 

IS.ESC Byte 0: 1 015401 © 
Byte 1: 33 

IS.ESQ Byte 0: 1 115401 
Byte 1l: 233 

IS.PND +00 000000 

IS.RDD +02 000002 

IS.SUC +01 000001 

IS.TMO +02 000002 

IS.TNC +02 000002 


B.2 DIRECTIVE CODES 


Meaning 


Successful completion with 
carriage return 


Successful completion on 
read terminated by CTRL/C 


Successful completion 
with ESCape 


Successful completion with 
an escape sequence 


I/O request pending 
Deleted data mark read 
Successful completion 


Successful completion on 
read terminated by time-out 


Successful transfer but 
message truncated (receiver 
buffer too small) 


This section lists error and success codes that can be returned in the 


directive status 


is issued. 


B.2.1 Directive Error Codes 


Name Decimal Octal 
IE.ACT -07 177771 
IE.ADP -98 177636 
IE.ALG -84 177654 
TE.AST -80 177660 


word at symbolic location SDSW when a QIO directive 


Meaning 
Task not active 
Invalid address 
Alignment error 


Directive issued 


from AST 


issued/not 


Name 


IE.CKP 


IE.FIX 


IE.HWR 


IE.IBS 


IE.IDU 


IE. IEF 


IE.ILU 


IE. ILV 


IE.INS 


IE.IOF 


IE.IPR 


IE.ITI 


IE.ITP 


IE.ITS 


IE.IUI 


IE.LNL 


IE.MAP 


IE.NSW 


IE.NVR 


IE.NVW 


IE.PNS 


IE.PTS 


IE.PRI 


IE.RBS 


IE.RSU 


IE.SDP 


ITE.TCH 


IE.ULN 


IE.UNS 


IE.UPN 


IE.WOV 


Decimal 
-10 
-09 
-06 


-08 


-03 


Octal 

177766 
177767 
177772 


177647 


177644 
177637 
177640 
177755 
177776 
177655 
177641 
177643 
177650 


177770 


177645 
177646 
177657 
177756 
177652 
177651 
177642 
177775 
177760 
177761 
177757 
177635 
177765 
177773 


177774 


177777 


177653 
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Meaning 
Issuing task not checkpointable 
Task already fixed/unfixed 
Device handler not resident 


Invalid send buffer size 


-(.GT. 255.) 


Invalid device or unit 
Invalid event flag (.GT. 64.) 
Invalid logical unit number 
Invaild vector specified 
Specified task not installed 
Window has I/0 in progress 
Invalid priority (.GT. 250.) 
Invalid time parameters 
Invalid TI parameter 


Directive inconsistent with 


task state 

Invalid UIC 

LUN locked in use 

Invalid mapping specified 

No swap space available 
Invalid region ID 

Invalid address window ID 
Partition/region not in system 
Partition too small for task 
Privileged violation 

Receive buffer is too small 
Resource in use 

Invalid DIC number or DPB size 
Task is checkpointable 
Unassigned LUN 


Insufficient dynamic 
for send 


storage 


Insufficient dynamic storage 


Address window allocation 


overflow 
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B.2.2 Directive Success Codes 
Name Decimal Octal Meaning 


IS.SUC +01 000001 Directive accepted 


B.3 I/0 FUNCTION CODES 


This section lists octal codes for all standard and device-dependent 
I/O functions. 


B.3.1 Standard I/O Function Codes 


Symbolic Code Subcode 

Name Word Equivalent (High Byte) (Low Byte) Meaning 

IO.ATT 001400 3 0 Attach device 
IO0.DET 002000 4 0 Detach device 

IO. KIL 000012 0 12 Cancel I/O requests 
IO0.RLB 001000 2 0 Read logical block 
I0.RVB 010400 21 0 Read virtual block 
IO.WLB 000400 1 ; 0 Write logical block 
IO0.WVB 011000 22 0 Write virtual block 


B.3.2 Specific A/D Converter I/O Function Codes - RSX-11M-PLUS Only 


Symbolic Code Subcode 
Name Word Equivalent (High Byte) (Low Byte) Meaning 
IO. RBC 003000 6 0 Initiate an A/D 


conversion 


B.3.3 Specific Card Reader I/O Function Codes - RSX-11M-PLUS Only 


Symbolic Code Subcode 
Name Word Equivalent (High Byte) (Low Byte) Meaning 
IO0.RDB 001200 2 200 Read logical block 


(binary) 


B.3.4 Specific Cassette I/O Function Codes - RSX-11M-PLUS Only 


Symbolic Code Subcode 
Name Word Equivalent (High Byte) (Low Byte) Meaning 
IO. EOF 003000 6 0 Write end-of-file 
gap 
IO. RWD 002400 5 0 Rewind tape 


I/O FUNCTION AND STATUS CODES 


Symbolic Code Subcode 

Name Word Equivalent (High Byte) (Low Byte) Meaning 
IO.SPB 002420 5 20 Space blocks 
IO.SFF 002440 5 40 Space files 


B.3.5 Specific Communication (Message-Oriented) I/O Function Codes - 
RSX-11M-PLUS Only 


Symbolic Code Subcode 
Name Word Equivalent (High Byte) (Low Byte) Meaning 

IO.FDX 003020 6 20 Set device to 
full-duplex mode 

I0.HDX 003010 6 10 Set device to 
half-duplex mode 

IO. INL 002400 5 0 Initialize device 
and set device 
characteristics 

IO.RNS 001020 2 20 Read logical block, 
transparent mode 

IO0.SYN 003040 6 40 Specify sync 
character 

IO.TRM 002410 5 10 Terminate 
communication, 
disconnecting from 
physical channel 

IO.WNS 000420 i 20 Write logical block 


with no sync leader 


B.3.6 Specific DECtape I/O Function Codes - RSX-11M-PLUS Only 


Symbolic Code Subcode 
Name Word Equivalent (High Byte) (Low Byte) Meaning 
IO.RLV 001100 2 100 Read logical block 
(reverse) 
IO.WLV 000500 J 100 Write logical block 
(reverse) 
B.3.7 Specific DECtape II I/O Function Codes 
Symbolic Code Subcode 
Name Word Equivalent (High Byte) (Low Byte) Meaning 
IO.WLC 000420 1 20 Write logical block 
with check 
IO0.RLC 001020 2 20 Read logical block 
with check 
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Symbolic Code Subcode 
Name Word Equivalent (High Byte) (Low Byte) Meaning 

I0.BLS 004010 10 10 Position tape 

IO0.DGN 004150 10 150 Run internal 
diagnostics 

B.3.8 Specific Disk I/O Function Codes 

Symbolic Code Subcode 

Name Word Equivalent (High Byte) (Low Byte) Meaning 

IO.RPB 001040 2 40 Read physical block 
(RX01, RLO1, RLO2 
only) 

TO.SEC Sense 
characteristics 
(RX02 only) 

000000 0 0 Single Density 
040000 100 0 Double Density 

IO.SMD 002510 5 110 Set media density 
(RX02 only) 

IO.WDD 001140 1 140 Write physical block 
with deleted data 
mark (RX02 only) 

TO.WLC 001020 1 20 Write logical block 
followed by write 
check (all except 
RX01, RX02) 

10.WPB 000440 i 40 Write physical block 
(RXO1, RXO02, RLOI, 
RLO2 only) 

B.3.9 Specific Graphics Display I/O Function Codes - RSX-11M-PLUS 

Only 
Symbolic Code Subcode 
Name Word Equivalent (High Byte) (Low Byte) Meaning 

I0.CON 015400 33 00 Connect to graphics 
device 

IO.CNT 017000 36 00 Continue DPU 

IO.DIS 016000 34 00 Disconnect from 
graphics device 

I10.STP 016400 35 00 Stop DPU 
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B.3.10 Specific ICS/ICR, DSS/DR I/O Function Codes - RSX-11M-PLUS 
Only 
Symbolic Code Subcode 
Name Word Equivalent (High Byte) (Low Byte) Meaning 

IO.CCI 014000 30 0 Connect a buffer to 
digital interrupt 
input 

10.CTI 015400 33 0 Connect a counter 

IO.CTY 003400 7 0 Connect a remote 
terminal 

IO.DCI 014400 31 0 Disconnect a buffer 


from digital 
interrupt input 


IO0.DTI 016000 34 0 Disconnect a buffer 
from counter input 

IO.DTY 006400 15 0 Disconnect a buffer 
from terminal input 

IO.FLN 012400 25 0 Place selected unit 
off line 

IO. ITI 017000 36 0 Initialize a counter 

IO.LDI 007000 16 0 Link a task to 
digital interrupts 

IO.LKE 012000 24 0 Link a task to error 
interrupts 

IO.LTI 007400 Ly 0 Link a task to 


counter interrupts 


IO.LTY 010000 20 0 Link a task to 
terminal interrupts 


IO0.MLO 006000 14 0 Open or close 
bistable digital 
output points 


IO0.MSO 005000 12 0 Pulse single-shot 
digital output 
points 

IO.NLK 011400 23 0 Unlink a task from 
all unsolicited 
interrupts 

IO.ONL 017400 37 0 Place selected unit 
on line 

IO.RAD 010400 21 0 Read task activation 
data 

IO.RBC 003000 6 0 Initiate multiple 


A/D conversions 
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Symbolic Code Subcode 
Name Word Equivalent (High Byte) (Low Byte) Meaning 

I0.SAO 004000 10 0 Perform analog 
output to specified 
channel 

IO.UDI 011410 23 10 Unlink a task from 

; digital interrupts 

IO.UER 011440 23 40 Unlink a task from 
error interrupts 

IO.UTI 011420 23 20 Unlink a task from 
counter interrupts 

IO. UTY 011430 23 30 Unlink a task from 
terminal interrupts 

IO0.WLB 000400 1 0 Output to remote 


terminal 


B.3.11 Specific LPA11-K I/O Function Codes - RSX-11M-PLUS Only 


Symbolic Code Subcode 

Name Word Equivalent (High Byte) (Low Byte) Meaning 
IO.CLK 015000 32 0 Start clock 
IO. INI 014400 31 0 Initialize LPA11-K 
IO0.LOD 014000 30 0 Load microcode 
IO.STA 015400 33 1 Start transfer 
I0.STP 016400 35 0 Stop request 


B.3.12 Specific LPS I/O Function Codes - RSX-11M-PLUS Only 


Symbolic Code Subcode 
Name Word Equivalent (High Byte) (Low Byte) Meaning 

IO.ADS 014000 30 0 Initialize A/D 
sampling 

IO.HIS 015000 32 0 Initialize histogram 
sampling 

IO0.LED 012000 24 0 Display number in 
LED lights 

IO.MDA 016000 34 0 Initialize D/A 
output 

IO.MDI 014400 31 0 Initialize digital 
input sampling 

IO.MDO 015400 33 0 Initialize digital 


output 


Symbolic 


Name 


IO. REL 


IO.SDI 


I0.SDO 


IO.STP 


B.3.13 Specific Magnetic Tape I/O Function Codes 


Symbolic 


Name 


IO.DSE 


IO. EOF 


IO.RLV 


IO.RWD 


IO0.RWU 


I0.SEC 


TO.SMO 


I0.SPB 
IO.SPF 


TI0.STC 


B.3.14 


B.3.14.1 


Symbolic 


Name 


IO.ATX 


I0.STC 


I0.SEC 
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Code Subcode 
Word Equivalent (High Byte) (Low Byte) 
013400 27 0 
013000 26 0 
012400 25 0 
016400 35 0 


Code Subcode 
Word Equivalent (High Byte) (Low Byte) 

003040 6 40 
003000 6 0 
001100 2 100 
002400 5 0 
002540 5 140 
002520 5 120 
002560 5 160 
002420 5 20 
002440 5 40 
002500 5 100 


Specific Parallel Communications Link 
RSX-11M-PLUS Only 


Transmitter Driver Functions - 


Code Subcode 
Word Equivalent (High Byte) (Low Byte) 
000400 1 0 
002500 5 100 
002520 5 120 


I/O Function 


Meaning 
Latch output relay 


Read digital input 
register 


Write digital output 
register 


Stop in-progress 
request 


Meaning 


Data security erase 
(TK50 only) 


Write end-of-file 
gap 


Read logical block 
(reverse) 


Rewind tape 
Rewind and unload 


Sense 
characteristics 


Mount and set 
characteristics 


Space blocks 
Space files 


Set characteristics 


Codes - 


Meaning 


Attempt message 
transmission 


Set master section 
characteristics 


Sense master section 
status 
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B.3.14.2 Receiver Driver Functions 

Symbolic Code Subcode 
Name Word Equivalent (High Byte) (Low Byte) 

IO0.CRX 014400 31 0 

IO.ATE 001000 2 — 0 

IO.RTF 015400 33 0 

I0.DRX 001500 32 0 


B.3.15 Specific Terminal I/O Function Codes 


Symbolic Code Subcode 
Name Word Equivalent (High Byte) (Low Byte) 
IO.ATA 001410 3 10 
I0.CCO 000440 1 40 
IO.EIO 017400 37 0 
I0.GTS 002400 5 00 
IO.HNG 003000 6 0 
IO.RAL 001010 2 10 
IO0.RNE 001020 2 20 
IO.RPR 004400 ll 00 
IO.RST 001001 2 1 
IO.RTT 005001 12 1 
IO.WAL 000410 1 10 
IO.WBT 000500 1 100 
SF .GMC 002560 5 160 
SEF.SMC 002440 5 40 


Meaning 


Connect for 
reception 


Accept transfer 
Reject transfer 


Disconnect from 
reception 


Meaning 


Attach device, 
specify 
unsolicited-input- 
character AST 


Write logical block 
and cancel CTRL/O 


Extended I/O 
Get terminal support 
HANGUP remote line 


Read logical block 
and pass all bits 


Read with no echo 
Read after prompt 


Read with special 
terminators 


Read logical block 
ended by specified 
special terminator 
(Full-duplex driver 
only) 


Write logical block 
and pass all bits 


Write logical block 
and break through 
on-going I/0 


Get multiple 
characteristics 


Set multiple 
characteristics 
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Subfunct:ion Bits: 


With 


TF.RST 
TF.BIN 
TF.RAL 
TF .RNE 
TF. XOF 
TF .TMO 


IO.RLB, 


With IO.WLB: 


TF .RCU 
TF .WAL 
TF .CCO 
TF .WBT 
TF .WIR 


With IO.ATT: 


TF .XCC 
TF .NOT 
TF .AST 
TF.ESQ 


With IO.EIO: 


TF .WLB 
TF .RCU 


TtF.ccol 


TF .WAL 


TF .wBT! 
TF.WIR? 


Modifiers 
specified 


Modifiers 
specified 


000001 
000001 
000040 
000010 
000100 
000200 


of the 
by you 


of the 
by you 


IO.RPR: 


000001 
000002 
000010 
000020 
000100 
000200 


000001 
000010 
000040 
000100 
000200 


000001 
000002 
000010 
000020 


TF.RLB 
TF.RLUZ 
TF. RTT 2 
TF.RST2 
TF.BINZ 
TF.RAL 

TF .RNE2 
TF.XOF 
TF. TMO 2 
TF .RES 

TF .RPR2 
TF.RPT2 
TF.RNF 

TF. TNE2 
TF.RDI 


B.3.16 

Symbolic Code 
Name Word Equivalent (High Byte) 

I0.CCI 014000 30 

IO.CTI 015400 33 

IO.DCI 014400 31 


000002 
000010 
000400 
000001 
000002 
000010 
000020 
000100 
000200 
010000 
002000 
004000 
020000 
040000 
100000 


IO.EIO!ITF.WLB subfunction. 
in the item-list buffer. 


IO.EIO!ITF.RLB subfunction. 
in the item-list buffer. 


Subcode 


(Low Byte) 


0 


These are 


These are 


Specific UDC I/O Function Codes - RSX-11M-PLUS Only 


Meaning 


Connect a buffer to 
contact interrupt 
digital input 


Connect a timer 
Disconnect a buffer 
from contact 


interrupt digital 
input 
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Symbolic Code Subcode 
Name Word Equivalent (High Byte) (Low Byte) Meaning 

I0.DTI 016000 34 0 Disconnect a timer 

IO. ITI 017000 36 0 Initialize a timer 

I0.MLO 006000 14 0 Open or close 
latching digital 
output points 

IO. RBC 003000 6 0 Initiate multiple 


A/D conversions 


B.3.17 Specific UNIBUS Switch I/O Function Codes - RSX-11M-PLUS Only 


Symbolic Code Subcode 
Name Word Equivalent (High Byte) (Low Byte) Meaning 

IO.CON 15400 33 0 Connect UNIBUS 
switch 

IO.DIS 16000 34 0 Disconnect UNIBUS 
switch 

IO.DPT 16010 34 10 Disconnect UNIBUS 
switch and connect 
to specified CPU 
port 

I0.SWI 16400 35 0 Switch UNIBUS from 
current CPU to 
specified CPU 

I0.CSR 15000 32 0 Read UNIBUS switch 


CSR 


B.3.18 Specific Virtual Terminal I/O Function Codes 


Symbolic Code Subcode 
Name Word Equivalent (High Byte) (Low Byte) Meaning 
I0.STC 002500 5 100 Set terminal 


characteristics 


APPENDIX C 


QIO$ INTERFACE TO THE ACPS 


This appendix describes the QIO$ level interface to the file 
processors (ACPs). These include FL1ACP for Files-l1l disks and MTAACP 
for ANSI magnetic tape. 


FLIACP supports the following functions: 


IO.CRE Create file 

IO. DEL Delete file 

IO.ACR Access file for read only 

IO. ACW Access file for read/write 
IO.ACE Access file for read/write/extend 
I0.DAC Deaccess file 

IO.EXT Extend file 

IO.RAT Read file attributes 

IO.WAT Write file attributes 

IO.FNA Find file name in directory 
IO.RNA Remove file name from directory 
IO.ENA Enter file name in directory 


IO0.ULK Unlock block 


MTAACP supports the following functions: 


IO.FNA Find file by name 

IO. ENA Enter name in directory (a no-op) 
IO.ACR Access for read only 

I0.ACW Access for read/write 

IO.ACE Access for read/write/extend 
I0.DAC Deaccess file 

IO.RVB Read virtual block 

IO.WVB Write virtual block 

IO.EXT Extend file 

IO0.CRE Create file 

IO.RAT Read attributes 

IO.APC ACP control 

IO.APV Privileged ACP control 


C.1 QIOS$ PARAMETER LIST FORMAT 


The device-independent part of a file processing QIOS parameter list 
is identical to all other QIO$ parameter lists. The general QIO 
parameter list is described in detail in Section 1.6 of this manual. 
The file processor QIOS$s require the following six additional words in 
the parameter lists: 


Parameter Word 1 Address of a 3-word block containing the 
file identifier 


Parameter Word 2 Address of the attribute list 
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Parameter Words 3 & 4 Size and extend control information 
Parameter Word 5 Window size information and access 
control 
Parameter word 6 Address of the file name block 
NOTE 


The Micro/RSX Executive treats File Identifier Blocks, 
filename blocks, and attribute list entries as 
read/write data. For this reason, they may not be 
used in read-only code segments or libraries. 


C.1.1 File Identification Block 


The File Identification Block is a 3-word block containing the file 
number and the file sequence number. The format of the File 
Identification Block is shown in Figure C-l. 


File number 


File sequence number 


Reserved 


ZK-4095-85 


Figure C-l1 File Identification Block 


F1I1ACP uses the file number as an index to the file header in the 
index file. Each time a header block is used for a new file, the file 
sequence number is incremented. This insures that the file header is 
always unique. The third word is not currently used but is reserved 
for the future. 


C.1.2 The Attribute List 


The file attribute list controls FIllACP reads or writes. File 
attributes are fields in the file header. These fields are described 
in detail in the RSX-11M/M-PLUS and Micro/RSX I/O Operations Reference 
Manual. 


The attribute list contains a variable number of entries terminated by 
an all-0 byte. The maximum number of entries in the attribute list is 
six. 


An entry in the attribute list has the following format: 


-BYTE <Attribute type>, Attribute size 
-WORD Pointer to the attribute buffer 


C.1.2.1 The Attribute Type - This field identifies the individual 
attribute to be read or written. The sign of the attribute type code 
determines whether the transfer is a read or write operation. If the 
type code is negative, the ACP reads the attribute into the buffer. 
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If the type code is positive, the ACP writes the attribute to the file 


header. 


Note that the sign of the type code must agree with the 


direction implied by the operation. For example, if the type code is 
positive, the operation must be an IO.WAT or IO.DAC. 


The attribute type is one of the following: 


File owner (H.FOWN) 


The file owner UIC is a binary word. The low byte is’ the 
owner number and the high byte is the group number. 


File protection (H.FPRO) 


The file protection word is a bit mask with the following 
format: 


Each of the fields contains four bits, as follows: 


Bit 1 Read Access 
Bit 2 Write Access 
Bit 3 Extend Access 
Bit 4 Delete Access 


File characteristics (H.UCHA) 


The following user characteristics are currently contained in 
the l-byte H.UCHA field: 


UC.CON 
UC.DLK 


200 Logically contiguous file 
100 File improperly closed 


Record I/O Area (U.UFAT) 


This field contains a copy of the first seven words of the 
file descriptor block. (RMS uses 32 bytes. The first seven 
are compatible with FCS for sequential files.) See the 
RSX-1L1M/M-PLUS and Micro/RSX I/O Operations Reference Manual 
for a description of the FDB. 


File name (I.FNAM) 

The file name is stored as nine Radix-50 characters. The 
fourth word of this block contains the file type and the fifth 
word contains the version number. 

File type (I.FTYP) 

The file type is stored as three Radix-50 characters. 

Version number (I.FVER) 

The version number is stored as a binary number. 


Expiration date (I.EXDT) 


Creation date (I.CRDT) 
Revision date (I.RVDT) 


The expiration date is currently unused. When the file is 
created, the ACP initializes the creation date to the current 
date and time. It initializes the expiration and _ revision 
dates to 0. The ACP sets the revision date to the current 
date and time each time the file is deaccessed. 
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e Statistics block 


This block is described in the RSX-11M/M-PLUS and Micro/RSX 
I/O Operations Reference Manual. 


e Read entire file header 


This buffer is assumed to be 1000 blocks’ long. You cannot 
write this attribute. . 


e Revision number (I.RVNO) 


The ACP sets the revision number to 0, and increments it every 
time the file is deaccessed. 


e Placement Control 


C.1.2.2 Attribute Size - This byte specifies the number of bytes of 
the attribute to be transferred. Legal values are from 1 to the 
maximum size of the particular attribute. Table C-l shows the maximum 
size for each attribute type. 


Table C-l 
Maximum Size for Each File Attribute 


Maximum 

Attribute Attribute Attribute Size 
Type Code Type in Octal Bytes 

1 File owner 6 

2 Protection 4 

3 File characteristics 2 

4 Record I/O area 40 

5 File name,type,version number 12 

€ File type 4 

7 Version number 2 

10 Expiration date 7 

11 Statistics block 12 

12 Entire file header 0 

13 Block size (magtape only) -- 

15 Revision number and 
creation/revision/expiration dates 43 
16 Placement control 16 
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C.1.2.3 Attribute Buffer Address - The attribute buffer address field 
contains the address of the buffer in the user's task space to or from 
which the attribute is to be transferred. 


C.1.3 Size and Extend Control 


These two parameters specify how many blocks the file processor 
allocates to a new file or adds to an existing file. These parameters 
also control the type of block allocation. 


The format is as follows: 


-BYTE <High 8 bits of size>, <extend control> 
-WORD <Low 16 bits of size> 


The size field specifies the number of blocks to be allocated to a 
file on I0O.CRE and IO.EXT operations, and the final file size on 
IO.DEL operations. 


The extend control field controls the manner in which an extend 
operation is to be done. The following bits are defined: 


EX.AC1=1 The extend size is to be added as a_ contiguous 
block. 

EX.AC2=2 Extend by the largest available contiguous piece up 
to the specified size. 

EX.FCO=4 The file must end up contiguous. 

EX.ADF=10 Use the default rather than the specified size. The 


default extend size is the size that was specified 
when the volume was mounted. 


EX.ALL=20 Placement control (see Section C.2). 


EX.ENA=200 Enable extend. 


C.1.4 Window Size and Access Control 


This parameter specifies the window size and access control 
information in the following format: 


-BYTE <window size>, <access control> 


This word is only processed if the high bit of the access control byte 
(AC.ENB) is set. 


Window size is the number of mapping entries. Specifying a negative 
window size minimizes window turns. If this byte is zero, the file 
processor uses the volume default. The size of the window allocated 
in the dynamic storage region is 6 times the number of mapping entries 
(each mapping entry is 3 words), plus 10 bytes for the window control 
block. 


On Micro/RSX systems with secondary pool support, the mapping entries 


are allocated in secondary pool. The window control block and a 
pointer to secondary pool are located in primary pool. 
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The following access control bits are defined: 

AC.LCK=1 Lock out further accesses for Write or Extend 

AC.DLK=2 Enable deaccess lock 
The deaccess lock sets the lock bit in the file header 
if the file is deaccessed as the result of a_ task 
exit without explicitly deaccessing the file. The 
lock bit is set by the executive. The lock bit is not 
set when the system crashes. 

AC. LKL=4 Enable block locking 

AC.EXL=10 Enable explicit block unlocking 

AC.ENB=200 Enable access 

AC.RWD=10 Rewind the volume (labeled and unlabeled magtape only) 


AC. UPD=100 Update mode (labeled magtape only) 


AC. POS=20 Do not position to end-of-volume (labeled magtape 
only) 
AC.WCK=40 Initiate driver write-checking 
NOTE 


Both AC.LKL and AC.EXL must be set if you want 
block locking. If you do not want block 
locking, both bits must be clear. Any other 
combination is an error. 


C.1.5 File Name Block Pointer 


This word contains the address of a 15-word block in the issuing 
task's space. This block is called the file name block. The file 
name -lock is described in detail in the RSX-11M/M-PLUS and Micro/RSX 
I/O Operations Reference Manual. 


The fields of the file name block that are particularly important in 
file-processing operations are: 


@e Directory identification (N.DID) 


This field is required for all disk operations. It specifies 
the directory to which the operation applies. This field is 
not used for tape operations. 


e File identification (N.FID) 


This field is required as input for enter operations. This 
field is returned as output by find and remove operations. 


@e File name (N.FNAM), type (N.FTYP), and version number (N.FVER) 


These fields are required as input to enter, find, and remove 
operations. For find and remove operations, the _ file 
processor locates the appropriate entry by matching the 
information in these fields with the directory entries. 
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e Status word (N.STAT) 
@e Wildcard context (N.NEXT) 


This field is required as input for wildcard operations. It 
specifies the point at which to resume processing. It is 
updated for the next operation. It must initially be set to 
0. 


C.2 PLACEMENT CONTROL 


The placement control attribute list entry controls the placement of a 
file in a particular place on the disk. You can specify either exact 
or approximate placement on IO.CRE and I0O.EXT operations. 


The placement control entry must be the first entry in the attribute 
list. 


The format of the placement control attribute list entry is as 
follows: 


BYTE ; Placement control,0 

-WORD ; High-order bits of VBN or LBN 

»WORK ; Low-order bits of VBN or LBN 

~-BLKW 4 ; Buffer to receive starting and ending LBN if 


; AL.LBN is set. 
The following bits are defined for the placement control field: 


AL. VBN=1 Set if block specified is a VBN; otherwise, the 
block is the LBN 


AL.APX=2 Set if you want approximate placement; 
otherwise, placement is exact 


AL.LBN=4 Set if you want starting and ending LBN information 


C.3 BLOCK LOCKING 


Block locking only occurs when the user accesses a file with AC.LKL 
and AC.EXL set in the access control byte of the parameter list. Any 
read or write operation causes a check to see if the block is locked. 


A write access locks a block for exclusive access. A write operation 
can only access a block that is not locked by any accessor. The only 
exception to this is an exact match with a previous lock owned by the 
same accessor. 


A read access locks a block for shared access. A read operation can 
access any block locked for shared access. 


The user must unlock a block with an explicit unlock request, I0O.ULK. 
IO.ULK may be used to unlock one or all blocks. 


If all accessors to a file have not requested block locking, the ACP 
returns an error (see Table C-2). 


When the file is deaccessed, all locks owned by the accessor are 
released. 


Each active lock requires eight bytes from the dynamic storage region. 
This storage is deallocated when the file is deaccessed. 
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C.4 SUMMARY OF F11ACP FUNCTIONS 


The following is a summary of the functions implemented in FIL1ACP. A 
list of accepted parameters follows each function. All parameters are 
required unless specified as optional. Parameters other than those 
listed are illegal for that function and must be 0. 


IO0.CRE 


IO0.DEL 


IO.ACR 
I0.ACW 


IO.ACE 


I0.DAC 


IO. EXT 


Create file 


#1 


#2 


#3 & #4 


#5 


The file identifier block is filled in 
with the file identifier and sequence 
number of the created file. 


Write attribute list and placement 
control list or both (optional) 


Extend control (optional) 

The amount allocated to the file is 
returned in the high byte of IOST(1) 
plus IOST(2). 


May be nonzero but must be disabled 


Delete or truncate file 


#1 


#3 & #4 


Optional if the file is accessed 


Size to truncate the file to. If not 
enabled, the file is deleted. If 
enabled, the remaining 31 bits specify 
the size the file is to be after 
truncation. The change in file 
allocation is returned in the high byte 
of IOST(1) plus IOST(2). This amount 
will be zero or negative. 


Access file for read only 


Access file for read/write 


Access file for read/write/extend 


#1 

#2 

#5 

Deaccess file 
#1 

#2 

#5 

Extend file 
#1 

#2 


File identifier pointer 
Read attributes control (optional) 


Access control must be enabled 


File identifier pointer (optional) 
Write attributes control list 


May be nonzero but must be disabled 


Optional if file is accessed 


Placement control attribute list 
(optional) 


I0.RAT 


IO.FNA 
IO.RNA 


IO. ENA 


IO.ULK 


IO. RVB 


I0.WVB 
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#3 & #4 Extend control 
The amount allocated to the file is 
returned in the high byte of IOST(1) 
plus IOST(2). 

Read attributes 

#1 Optional if file is accessed 

#2 Read attributes control list 

Find name in directory 

Remove name from directory 

Enter name in directory 

#5 May be nonzero but must be disabled 

#6 File name block pointer 

Unlock block 


#2 0 or count of blocks to unlock 


#4 & #5 Starting VBN to unlock or 0 to- unlock 
all blocks. 


Read virtual block 


Write virtual block 


#1 User buffer 
#2 Buffer length 
#4 & #5 VBN 


C.5 SUMMARY OF MTAACP FUNCTIONS 


The following is a summary of the functions implemented in MTAACP. A 
list of accepted parameters follows each function. All parameters are 
required unless specified as optional. Parameters other than those 
listed are illegal for that function and must be 0. 


IO.FNA 


Find file by name 


#5 AC.RWD set in the access control byte 
indicates that the volume is to be 
rewound prior to the search. 


#6 Pointer to file name block. 
The following fields are used as input: 


N.FNAM 
N.FTYP 
N.FVER 
N.STAT 


I0.ENA 


I0.ACR 


I0O.ACW 


IO.ACE 


I0.DAC 


IO. RVB 
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The following fields are returned by 
MTAACP: 


N.FID 
N.FNAM 


N.FTYP 

N.FVER 

N.STAT 

Enter name in directory 
A no-op for magnetic tape 


Access for read only 


#1 File identifier pointer. Used to 
position a tape by file identifier. 

#2 Read attribute list (optional) 

#5 Ignored 


Access for read/write 


This function will be rejected with the error code 
IE.PRI. (Extend access is required.) 


Access for read/write/extend 


#1 File identifier pointer. Used to 
position tape by file identifier. 


#2 Read attribute list (optional) 


#5 AC.UPD (update mode). If AC.UPD is set, 
the tape will be positioned to overwrite 
the file and all files beyond the 
current file will be lost. If AC.UPD is 
not set, the tape will be positioned for 
append. If the file is not the last 
file, MTAACP returns the error code 


IE.ISQ. 
Deaccess file 
#1 File identifier pointer is ignored. 
#5 AC.RWD set indicates that the volume is 


to be rewound after the file is closed. 
Read virtual block 
#1 Buffer address 
#2 Buffer size. The buffer size must be 


greater than 18 bytes and less than the 
declared block length for the entire 


file. 
#4 High VBN 
#5 Low VBN 


The virtual block number must be either zero or exactly 
one greater than the previous block number. 


I0.CRE 


IO.RAT 
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Create File 


#1 File identifier pointer. The file 
sequence and section number will be 
returned to the user's file identifier 
block. 


#2 Attribute list pointer. Used to write 
the attributes for the newly created 
file. Attribute type code must be 


positive. 

#5 If AC.RWD is set, the volume will be 
positioned at the beginning and will 
overwrite the first file. This 


effectively reinitializes the volume. 


If AC.RWD is not set and AC.POS is set, 
the volume set will be positioned to the 
next file position beyond the current 
file and will overwrite that file. All 
files beyond that on the volume will be 
destroyed. 


If neither AC.RWD nor AC.POS is set, the 
volume set will be positioned at its end 
and the new file will be appended to the 
set. 


For unlabeled tapes, MTAACP only checks 
AC.RWD. 


#6 Filename block pointer. 


Read Attributes 


#1 File identifier pointer. Used to 
position the tape by the file 
identifier. 

#2 Attribute list pointer (see Section 
CelZ) 


The following attribute list entries are 
meaningful for magnetic tape: 


15.2 UIC 

1,4 UIC and protection 

L;5 UIC, protection, and 
characteristics 

Protection 

Protection and characteristics 
Characteristics 

User file attributes 

File name 

File name and type 

File name and type 

File type 

File type and version number 
Version number 

Expiration date 

-9,10 Statistics block (read only) 
-10,0 Entire header (read only) 
11,2 Block size 


es 


“SIN BNF © OV WE WD 
Np 


Oo 


QIO$ INTERFACE TO THE ACPS 


IO.APC ACP Control 
#3 One of the following user control 
function codes: 

1 Rewind volume set. 

2 Position to end of volume set. 

3 Close current volume and 
continue processing the next 
section of the same file on the 
next volume of the volume set. 

4 Space physical records in 
currently accessed file. 

5 Get ACP characteristics. 

6 Rewind current file. 

IO.APV Privileged ACP Control 
This function is used only by the MOUNT and DISMOUNT 
commands. This interface is subject to change and, 
therefore, will ‘not be documented until ae future 
release. 


C.6 HOW TO USE THE ACP QIOS$ FUNCTIONS 

Although the operations described in this appendix are normally 
perforned by the file-access methods (RMS and FCS), your application 
may issue the ACP QIOS$s. The required parameters for each QIO$ are 
described in the preceding section. The necessary steps for common 
operations are described in the following section: 


NOTE 


The file identifier is the only way to refer to a 
file. 


C.6.1 Creating a File 
To create a file: 
e Use IO.CRE to create it. 


e Enter it in the Master File Directory (MFD) or aé_euser 
directory with IO.ENA. 


C.6.2 Opening a File 
To open a file: 


e Use I0O.FNA to find the File Identifier of the directory in the 
MFD. 


e Use I0O.FNA to find the File Identifier of the file in the 
directory. 


e Access the file with IO.ACR, IO.ACW, or IO.ACE. 
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C.6.3 Closing a File 
To close a file: 


@e® Deaccess the file with IO.DAC. 


C.6.4 Extending a File 
To extend a file: 


e Use IO.FNA to find the file identifier 
accessed. 


e Use IO.EXT to extend the file. 


C.6.5 Deleting a File 


To delete a file: 


if the file is not 


e Use IO.FNA to find the file identifier. 


e Use IO.RNA to remove the directory name. 


e Use IO.DEL to delete the file. 


C.7 ERRORS RETURNED BY THE FILE PROCESSORS 


The error codes returned by FI1ACP and MTAACP are shown in Table C-2. 


Table C-2 


File Processor Error Codes 


Error 

Code Operations Explanation 

IE.ABO I0.RVB/IO.WVB Indicates that not all requested 
data was transferred by the 
device. 

IE.ALC Extend or create Indicates that the operation 
failed to allocate the file 
because of placement control or 
because of other related 
problems. 

IE.ALN Access a file Indicates that a file is already 
accessed on that LUN. 

IE.BAD Any function Indicates that a required 


parameter is missing, that a 
parameter that should not be 
present is present, that a 
parameter that must be disabled 


is enabled, 


or that a parameter 


value is invalid. 


(Continued on next page) 


Error 
Code 


IE.BDR 


IE.BHD 


IE.BVR 


IE.BYT 


IE.BTP 


IE.CKS 


IE.CLO 


IE.DFU 


IE.DUP 


IE.EOF 
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Table C-2 (Cont.) 
File Processor Error Codes 


Operations 


Directory 


Any 


Directory 


Any function 


Create unlabeled Magtape 


Any 


File access 


Allocation request 


Enter name 


IO0.RVB/IO.WVB/IO.DEL 


Explanation 


Indicates that you attempted a 
directory operation on a file 
that is not a directory, or that 
the specified directory is 
corrupted. This is usually 
caused by a 0 version number 
field. 


Indicates that a corrupt file 
header was encountered, or that 
the operation required a feature 
not supported by the FCP (such as 
multiheader support or support 
for unimplemented features). 


Indicates that you attempted to 
enter a name in a directory with 
a negative or 0 version number. 


This error is returned if the 
buffer specified is on an odd 
byte boundary or is not a 
multiple of four bytes. 


An attempt was made to create an 
unlabeled tape file with a record 
type other than fixed. 


Indicates that the checksum of a 
file header is incorrect. 


Indicates that the file was 
locked against access by the 
"deaccess lock bit." 


Indicates that there is 
insufficient free disk space for 
the requested allocation. 


Indicates that the name and 
version already exist. 


On read operations, this 
indicates an attempt to read 
beyond end of file. On truncate 
operations, it indicates an 
attempt to truncate a file toa 
length longer than that allocated 
or that the file was already at 
EOF. 


(Continued on next page) 


Error 
Code 


IE.HFU 


IE.IFC 


IE.IFU 


IE.LCK 


IE.LUN 


IE.NOD 


IE.NSF 


IE.OFL 


IE. PRI 
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Table C-2 (Cont.) 
File Processor Error Codes 


Operations 


Extended 


Executive 


Create or extend 


File access, 
directory, and 
truncate 


Any requiring 
file ID 


All requiring DSR 


All file 


Executive 


Any 


Explanation 


Indicates that the file header is 
full and cannot contain any more 
retrieval pointers and that 
adding an extension header is not 
allowed. When this error code is 
returned on a create operation, 
it indicates that the index file 
could not be extended to allow a 
file header to be allocated. 


Illegal function code. 


Indicates that there are no file 
headers available based on the 
Parameters specified when the 
volume was initialized. 


Indicates that the file 

is already accessed by a 

writer and that shared write has 
not been requested or is not 
allowed. 


Indicates that file ID 

has not been supplied and that 
the file is not accessed on the 
LUN. 


Indicates that an I/O request 
failed because of IE.UPN, and 
that the FCP was unable to 
allocate required space from DSR 
or from secondary pool for data 
structures. 


Indicates that the specified 
directory entry does not exist, 
that a file corresponding to the 
file ID does not exist, or that 
the file is marked for delete. 


The device is off line. 


Indicates that the user does not 
have the required privilege for 
the requested operation, or that 
the user has not requested the 


‘proper access to the file if the 


(Continued on next page) 


Error 
Code 


IE.RER 


IE.SNC 


IE.SPC 


IE.SQC 


IE.WAC 


IE.WAT 


IE.WER 


IE.WLK 
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Table C-2 (Cont.) 


File Processor Error Codes 


Operations 
Any 
Any 
Executive 
Any 


File access 


Write attributes 
and deaccess 


Any 


Any requiring 
write access 


Explanation 


file is already accessed (for 
example, in an attempt to write 
to a file that is accessed for 
read). This error code also 
indicates an attempt to do file 
I/O to a device that is not 
mounted. 


Indicates that the FCP 
encountered a fatal device read 
error during an operation; the 
operation has been aborted. 


Indicates that the file number 
and the value contained in the 
header do not agree. This 
generally means that the header 
has gone bad because of a crash 
or a hardware error. 


Indicates an illegal buffer. 


Indicates that the file sequence 
number does not agree with the 
file header; usually indicates 
that the file has been deleted 
and the header has been reused. 


Indicates that the file is 
already write accessed and lock 
against writers is requested. 


Indicates that the FCP 
encountered an invalid attribute. 


Indicates that the FCP 
encountered a fatal device write 
error during an operation. The 
operation has been aborted, but 
the disk structure may have been 
corrupted. 


Indicates that the volume 
is software write-locked. 


Abort 
active task, 
CTRL/C, 2-9 


2-11 


task (tape driver), 4-11 
Abort operation 

tape driver, 4-6 
AC.DLK (F1LI1ACP), C-6 
AC.ENB (F11ACP), C-6 
AC.EXL (F1L1ACP), C-6, C-7 
AC.LCK (FLI1ACP), C-6 
AC.LKL (F11ACP), C-6, C-7 
AC.POS (F11ACP), C-6 
AC.POS (MTAACP), C-1l 
AC.RWD (FLIACP), C-6 
AC.RWD (MTAACP), C-10, C-ll 
AC.UPD (F11ACP), C-6 
AC.UPD (MTAACP), C-10 
AC.WCK (FIL1ACP), C-6 
Access 

control 


enabling, C-8 
control (F1L1ACP), C-5 
enabling, C-6 
file 
read/write, C-8 
read/write/extend, C-8 
lock out, C-6 
read, C-10 
read/write, C-10 
read/write/extend, C-10 
ACP 
control 
IO.APC, C-12 
privileged, C-12 
creating a file, C-12 


File Identification Block, C-2 


get characteristic, C-12 

opening a file, C-12 

QIOS 

parameter list, C-l 

QIOS$ function use, C-12 

QIOS interface, C-1l 

unique (RC25), 3-10 
Address 

illegal (tape driver), 4-8 

illegal space (VTDRV), 6-8 

logical (disk driver), 3-3 

virtual (disk driver), 3-3 
Address space 

invalid (VTDRV), 
AL.APX (FLIACP), C- 
AL.LBN (FLIACP), C- 
AL.VBN (FILI1ACP), C- 
ALUNS macro, 1-4, 1-15, 1-17 

dev, 1-17 

example, 1-17 

lun, 1-17 

unt, 1-17 
Ancillary Control Processor 

See ACP 


6-8 
7 
7 
7 


INDEX 


ASSIGN, as Task Builder option, 


1-4 


AST, 1-5, 


1-9, 


1-10, 


1-11 


address as QIOS parameter, 1-5 
armed (TTDRV), 
attach terminal (TTDRV), 


blocking, 
Directive Status Word, 
disarmed (TTDRV), 2-14 
event flag, 1-11 
multiple buffering, 1-12 
Program Counter, 
purpose, 
queuing, 
routine 
entering 


1-11 


1-11 
1-11, 


interrupting, 


2-14 


1-12 


1-12 


(TTDRV), 2-7 
1-11 
service routine, 1-ll, 
service termination, 
specifying in macro, 1-11 


le 


1c 
1-22 


2-13 


12 


12 


unsolicited input character 


(TTDRV), 
Ast parameter, 


2-7 
1-9 


I/O completion, 1-33 


introduction (TTDRV), 


IO.ATT 
I0.CCO 
IO. EIO 
I0.GTS 
IO.HNG 
IO.RAL 
IO. RNE 
IO.RPR 
IO.RST 
IO.RTT 
IO.WAL 
IO.WBT 
SF. GMC 
SF.SMC 


function 
function 
function 
function 
function 
function 
function 
function 
function 
function 
function 
function 
function 
function 


Ast2 parameter 


introduction (TTDRV), 


(TTDRV), 
(TTDRV) , 
(TTDRV), 
(TTDRV) , 
(TTDRV) , 
(TTDRV) , 
(TTDRV) , 
(TTDRV) , 
(TTDRV), 
(TTDRV) , 
(TTDRV), 
(TTDRV) , 
(TTDRV), 
(TTDRV), 


2-6 


2-6 


2-13 
2-16 
2-19 
2-26 
2-28 
2-29 
2-31 
2-34 
2-37 
2-39 
2-41 
2-44 
2-46 
2-54 


IO.ATT function (TTDRV), 2-14 
ASTXS$ macro, 1-15 


err, l- 
syntax, 
ASTXSS macro, 


22 
1-22 


112, 


1-22 


Asynchronous line interface, 2-2 
Asynchronous System Trap 


See AST 


Attach 


device, 
device (tape driver), 4-6 
device LUN, 1-25 


1-25 


terminal (TTDRV), 2-13 


terminal AST (TTDRV), 
Attach (VTDRV), 
Attribute 


buffer 


address, 


control list 


read, 


Index-1l 


C-9 


6-4 


C-5 


2-13 


INDEX 


Attribute 
control list (Cont.) 
write, C-8 
control read, C-8 
list 


entry (FLILACP), C-7 
entry (MTAACP), C-11 
FLIACP, C-2 
placement control, C-8 
pointer, C-ll 
write, C-8 

read, C-9 

size, C-4 
table, C-4 

type (FLIACP), C-2, C-3 

Auto-call modem (TC.DLU), 2-47 


Backslash echo (DELETE), 2-66 
Bad parameter (VTDRV), 6-8 
Beginning of tape 
See BOT 
ea parameter (disk driver), 
-3 
Block 
size 
NOCLABEL (TU58), 4-17 
Size (tape driver), 4-10 
BOT space operation (tape driver), 
Breakthrough write, 2-10 
TI0.CCO function (TTDRV), 2-17 
IO.EIO function (TTDRV), 2-22 
IO.WAL function (TTDRV), 2-43 
IO.WBT function (TTDRV), 2-44 
Buffer 
address (disk driver), 3-5 
allocating, 2-74 
byte-aligned (tape driver), 4-6 
character, 2-72 
data (tape driver), 4-12 
enable 
I0.STC function (VTDRV), 6-4 
flush, 2-8, 2-73 
CTRL/C, 2-73 
CTRL/X, 2-73 
detached terminal, 2-73 
flush exception 
CTRL/C, 2-73 
CTRL/X, 2-73 
full 
escape sequence processing, 
2-69 
unsolicited input, 2-51 
hardware timing, 2-57 
input, 2-74 
offspring task (VTDRV), 6-4 
output, 2-72, 2-74 
private pool, 2-74 
prompt (VTDRV), 6-3 
retrieving character, 2-73 
Size (disk driver), 3-5 
task, 2-72 
type-ahead, 2-72 
character echo, 2-73 


Buffer 
type-ahead (Cont.) 

character storing, 2-72 
CTRL/C, 2-73 

CTRL/O, 2-73 

CTRL/Q, 2-73 

CTRL/S, 2-73 

CTRL/X, 2-73 

unprocessed character, 2-53 


Cancel CTRL/O, 2-7, 2-42 
IO.EIO function (TTDRV), 2-19 
IO.WBT function (TTDRV), 2-45 
Carriage return, automatic, 2-71 
Case conversion, 2-9, 2-30, 2-57 
disabling, 2-57 
IO.RPR function (TTDRV), 2-35 
IO.RST function (TTDRV), 2-37 
Cb parameter 
device-specific function 
(VTDRV), 6-3 
IO.STC function (tape driver), 
4-4 
IO.STC function (VTDRV), 6-5 
Characteristic 
error (VTDRV), 6-8, 6-9 
resetting (tape driver), 4-11 
return (tape driver), 4-5 
setting 
effect, 2-57 
TC.HLD, 2-57 
TC.SMR, 2-57 
TC.SSC, 2-57 
tape driver, 4-1 
terminal (VTDRV), 6-7 
Characteristic bit 
special information (TTDRV), 
2-52 
VTDRV, 6-3 
Checkpoint 
offspring task (VTDRV), 6-4 
task, 2-9 
buffering, 2-74 
terminal input, 2-76 
CLI 
CTRL/C, 2-11 
CTRL/C processing, 2-65 
setup, 2-65 
input, 2-11 
operation (TTDRV), 2-65 
prompt, 2-9 
Close file, C-13 
Code 
directive status, B-l 
error 
testing for, 2-58 
I/O completion, B-l 
I/O status, B-l 
Success, B-5 
return 
testing for, 2-58 
status, 2-58 
Command Line Interpreter 
See CLI 
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INDEX 


CTRL/Q (Cont.) 

terminator, 2-9 

TF.RAL, 2-35 

TF.RST, 2-30 

type-ahead buffer, 2-73 
CTRL/R, 2-32, 2-64 

ignored, 2-8 

IO.RAL function (TTDRV), 2-64 

IO.RNE function (TTDRV), 2-31 


CP.CTC 
in CPB of CLI, 2-65 
Create file, C-8, C-1ll 
ACP, C-12 
CTRL/C, 2-32, 2-62 
abort, 2-9, 2-11, 2-30, 2-32 
IO.RPR function (TTDRV), 2-35 
IO.RST function (TTDRV), 2-37 
CLI processing, 2-65 


CLI setup (TC.TLC), 2-65 IO.RPR function (TTDRV), 2-33, 
disable, 2-57 2-35 
driver interpretation, 2-32 IO.RST function (TTDRV), 2-37, 


during read, 2-65 2-38, 2-64 
exclude (IO.ATA), 2-15 pass through 
flush buffer, 2-73 as normal character, 2-8 


exception, 2-73 
IO.RAL function (TTDRV), 2-29, 
2-65 
IO.RST function (TTDRV), 2-37, 
2-38, 2-65 
IO.RTT function (TTDRV), 2-40 
pass through as normal 
character, 2-9 
prompt, 2-9 
IO.RPR function (TTDRV), 2-35 
restarting suspended output 
after CTRL/S in CLI, 2-65 


read no echo, 2-30 
resynchronize display, 2-67 
TF.RAL, 2-64 

TF.RNF, 2-64 

TF.RNO, 2-40 

TF.RST, 2-30, 2-64 

write breakthrough, 2-43 


CTRL/S, 2-32, 2-64 


driver interpretation, 2-32 
in CLI 

CTRL/C restarts output, 2-65 
intercept, 2-9 


TF.RAL, 2-35 IO.RAL function (TTDRV), 2-29, 
TF.RST, 2-30 2-64 
type-ahead buffer, 2-73 IO.RPR function (TTDRV), 2-35 
unsolicited input, 2-65 IO.RST function (TTDRV), 2-37 
CTRL/I, 2-62 IO.RTT function (TTDRV), 2-39, 
CTRL/J, 2-63 2-40 
CTRL/K, 2-63 stopping write breakthrough, 
CTRL/L, 2-63 2-11 
CTRL/M, 2-63 TC.TSY, 2-64 
CTRL/O, 2-32, 2-63 terminator, 2-9 
cancel, 2-16 TF.RAL, 2-35, 2-64 
IO.EIO function (TTDRV), 2-19 TF.RST, 2-30 
IO.WAL function (TTDRV), 2-42 TF.XOF, 2-22 
IO.WBT function (TTDRV), 2-45 TTSYNC, 2-64 
driver interpretation, 2-32 type-ahead buffer, 2-73 
IO.RAL function (TTDRV), 2-29 write breakthrough, 2-43 
IO.RPR function (TTDRV), 2-35 CTRL/U, 2-32, 2-64 
IO.RST function (TTDRV), 2-37 IO.RAL function (TTDRV), 2-64 
IO.RTT function (TTDRV), 2-40 IO.RPR function (TTDRV), 2-33, 


pass through as normal 2-35 
character, 2-9 IO.RST function (TTDRV), 2-37, 
TC.PTH, 2-63 2-64 


pass through 
as normal character, 2-8 

TF.RAL, 2-64 

TF.RNF, 2-64 

TF.RPT, 2-64 

TF.RST, 2-30, 2-64 

CTRL/X, 2-64 

flush buffer, 2-73 

exception, 2-73 


terminator, 2-9 
TF.RAL, 2-35 
TF.RST, 2-30 
type-ahead buffer, 2-73 
write breakthrough, 2-43, 2-44 
CTRL/Q, 2-32, 2-64 
driver interpretation, 2-32 
intercept, 2-9 
IO.RAL function (TTDRV), 2-29 
IO.RPR function (TTDRV), 2-35 IO.RAL function (TTDRV), 2-64 
IO.RST function (TTDRV), 2-37, IO.RST function (TTDRV), 2-38, 
2-38 2-64 
IO.RTT function (TTDRV), 2-39, TF.RAL, 2-64 
2-40 TF.RPT, 2-64 
TC.TSY, 2-64 TF.RST, 2-64 
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INDEX 


CTRL/X (Cont.) 
type-ahead buffer, 2-73 
CTRL/x character, 2-62 


CTRL/Z, 2-64, 2-66 
driver interpretation, 2-32 
IO.RAL function (TTDRV), 2-29, 

2-64 
IO.RST function (TTDRV), 
2-64 
IO.RTT function (TTDRV), 2-40 
pass through as normal 
character, 2-9 
TF.RAL, 2-35, 2-64 
TF.RPT, 2-64 
TF.RST, 2-64 

Cursor 

control, 2-74 
IO.WLB function 
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VTDRV, 6-7 block unlocking, C-9 
ESC key, 2-66 enable specific, C-6 
Escape sequence, 2-67 request, C-7 
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IO.EXT, C-13 
~EXTND routine (disk driver), 
3+4 
finding by name, C-9 
header, C-4 
identification (FI1l1lACP), C-6 
identifier, C-12 
block, C-8 
IO.FNA, C-12, C-13 
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revision date, C-3 
rewinding, C-12 
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1-36 
address, as QIOS parameter, 1-5 
example, 1-36 
SF.GMC function (TTDRV), 2-46 
contents, 2-46 
SF.SMC function (TTDRV), 2-54 
I/O subfunction summary 
terminal driver, A-3 
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disk driver, 3-3, 3-6 
file processor, C-13 
printer driver, 5-3 
tape driver, 4-6 
TTDRV, 2-58 
VTDRV, 6-7 
IE.ADP error return, 1-35 
IE.ALC error return 
file processor, C-13 
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IO.ACR function 
access file, C-12 
FLIACP, C-8 
MTAACP, C-10 
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IO.DSE function (tape driver), 
4-4, 4-5 
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IO.RLV function (tape driver), disk driver, 3-5 
4-3, 4-4 NLDRV, 7-1 
IO.RNA function printer driver, 5-3 
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2-62, 2-64, 2-65 I/O completion, 1-33 
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assembler directive, 
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Nbs parameter 
IO0.STC function (tape driver), 
4-4 
Nes parameter 
IO0.STC function (tape driver), 
4-4 
NLDRV, 7-1 
example, 
output, 
NOLABEL 
block size (TU58), 
tape (tape driver), 
Not ready 
tape driver, 4-7 
TU58, 4-16 
Null device driver 
See NLDRV, 7-1 


7-1 
7-1 


4-17 
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Odd data byte (tape driver), 4-12 
Off line (tape driver), 4-8 
Offspring task (VTDRV), 6-1 
buffering, 6-4 
checkpoint, 6-4 
stop, 6-4 
OOB 
character, 
CLEAR, 2-57 
HELLO, 2-57 
INCLUDE, 2-57 
Open a file (ACP), C-12 
Operation aborted (tape driver), 
4-6 
Out-of-band character 
See OOB 
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Overhead, system, 2-9 
Overlap seek (disk driver), 3-4 


Padding character 
tape driver, 4-13 
TU58, 4-17 
Parameter 
device-dependent, 1-5, 1-9 
function-dependent, 1-5, 1-9 
list 
ACP, C-l 
QIOS (TTDRV), 2-6 
Parameter2 parameter 
IO.ATT function (TTDRV), 2-14 
TTDRV, 2-6 
Parent task 
buffering (VTDRV), 6-4 
Pass all (IO.RTT), 2-40 
Pass-through mode, 2-9 


Pbn parameter (disk driver), 3-5 


Performance 
RC25 stall I/0, 3-9 
Physical 
device name, 1-18 
I/O, 1-2 


logical unit 
association, 1-2 
Physical block number (disk 
driver), 3-5 
Placement 
approximate, C-7 
control, C-4 
control (F1LIACP), C-7 
control attribute list, C-8 
control field bit, C-7 
control list format, C-7 
Position tape (TU58), 4-16 
Power-fail 
disk driver, 3-8 
tape driver, 4-10 
Power-fail recovery, 1-40 
disk driver, 3-8 
Pradd parameter 
device-specific function 
(VTDRV), 6-3 
IO.RPR function (TTDRV), 2-34 
TTDRV, 2-6 
Pri parameter, 1-8 
IO.ATT function (TTDRV), 2-13 
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IO. EIO 
I0.GTS 
IO.HNG 
IO.RAL 
IO. RNE 
IO.RPR 
IO.RST 
IO.RTT 
IO.WAL 
IO.WBT 
SF.GMC 
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Programming hint 
disk driver, 3-8 
printer driver, 5-5 
tape driver, 4-10 
TU58, 4-17 
Prompt 
binary 
IO.EIO (TTDRV), 2-19 
TF.BIN (TTDRV), 2-7, 2-35 
read after 
TF.RPR (TTDRV), 2-9 
redisplay 
IO.RPR (TTDRV), 2-33 
TF.RPR (TTDRV), 2-9 
then read 
IO.RPR (TTDRV), 2-33 
Protection word 
file, C-3 
Prsize parameter 
device-specific function 
(VTDRV), 6-3 
IO.RPR function (TTDRV), 2-34 
TTDRV, 2-6 
Pseudo-device, 1-18 
name, 1-19 


QIOS, 1-2 
ACP interface, C-l 
angle bracket, 1-6 
ast parameter, 1-9 
basic operation, 1-2 
brace, 1-6 
bracket, 1-6 
brief specific (TTDRV), 2-3 
device-specific (TTDRV), 2-12 
efn parameter, 1-8 
fnc parameter, 1-7 
function 
ACP use, C-12 
allowed subfunction, 2-12 
device-specific 
disk driver, 3-5 
tape driver, 4-4 
VTDRV, 6-2 
Standard, 1-24 
function summary 
F11ACP, C-8 
MTAACP, C-9 
isb parameter, 1-8 
issuing, 1-4 
issuing (tape driver), 4-12 
lun parameter, 1-7 
macro, 1-14, 1-15 
TTDRV specific, 2-4 
macro condition, 1-35 
macro format, 1-6 
Parameter list 
ACP, C-l 
pri parameter, 1-8 
purpose, 1-2 
queuing, 1-5 
sequence (tape driver), 4-12 
standard 
brief (TTDRV), 2-3 
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QIOS (Cont.) 
Standard function 
disk driver, 3-3 
NOP, as, 1-24 
TTDRV, 2-12 
VTDRV, 6-2 
status condition, 1-35 
subfunction bits (TTDRV), 
syntax element, 1-6 
QIOS macro 
device-specific function 
disk driver, 3-4 
tape driver, 4-3 
TU58, 4-15 
VTDRV, 6-4 
disk driver, 3-3 
printer driver, 5-2 
Standard function 
priater driver, 
tape driver, 4-2 
TU53, 4-14 
VTDRV, 6-4 
VTDRV, 6-2 
QIOS parameter, 
trap-dependent, 
TTDRV, 2-6 
typical, 1-5 
QIosc 
DPB generation, 1-15 
macro form, 1-14 
QIOSC parameter, 1-14 
QIOSS 
DPB generation, 
macro form, 1-14 
QIOWS macro, 1-14, 
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1-14 
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1-15 
1-15 


RC25, 3--1 
dismounting, 3-10 
I/O delay, 3-10 
performance in stall I/O, 
spin-down, 3-9 
unique ACP, 3-10 
RDAFS Executive macro, 
RDXFS Executive macro, 
Read 
access, C-10 
file, C-8 
after prompt, 2-9 
IO.EIO function (TTDRV), 
IO.KPR (IO.RPR), 2-33 
after prompt (VTDRV), 6-6 
all characters, 2-8, 2-29 
IO.EIO function (TTDRV), 
IO.RNE function (TTDRV), 
IO.RPR function (TTDRV), 
IO.RST function (TTDRV), 
IO.RTT function (TTDRV), 
attribute, C-9, C-ll 
control, C-8 
control list, C-9 
case conversion, 2-8 
IO.EIO function (TTDRV), 
CTRL/C, 2-65 
default input, 
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2-38 
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Read 
default input (Cont.) 
IO.EIO function (TTDRV), 
escape sequence processing 
IO.EIO function (TTDRV), 
logical, 1-27 
check (disk driver), 3-5 
logical block, 2-8, 2-37 
special terminator, 2-37 
logical block (VTDRV), 
no echo, 2-8 
IO.EIO function 
IO.RAL function 
IO.RNE function 
IO.RPR function 
IO.RST function 
IO.RTT function 
no filter, 2-8 
IO.EIO function 
operation 
MSDRV, 4-10 
pass-through 
pass-through mode, 
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special characters (IO.EIO), 
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special terminator, 
IO.RAL function, 
IO.RNE function, 
IO.RPR function, 
terminator 
no echo, 2-10 
no echo (IO.EIO), 
table, 2-10 
table (IO.EIO), 
table (IO.RTT), 
time-out, 2-10 
IO.EIO function, 
IO.RAL function, 
IO.RNE function, 
IO.RPR function, 
IO.RST function, 
IO.RTT function, 
virtual, 1-28 
virtual block, C-9, C-10 
virtual block (VTDRV), 6-4 
write breakthrough, 2-44 
Read (TU58), 4-15 
Read/write access, 
file, C-8 
Read/write/extend access, 
Ready 
printer driver, 
tape driver, 4-7 
Record 
I/O area, C-3 
space, C-12 
REDIRECT command, 
Remote terminal 
IO.EIO function (TTDRV), 
Request terminated (VTDRV), 
Retry 
MSDRV, 4-10 
MUDRV, 4-10 
RETURN character, 
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Return 
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code, 1-34 


SF.SMC function 


directive condition, 1-34 full-duplex operation, 2-73 
I/O status condition, 1-34 I/O status block (TTDRV), 2-54 
testing for, 2-58 TTDRV, 2-54 
RETURN key, 2-66 VTDRV, 6-3 
Revision number, C-4 Significant event, 1-9, 1-13, 
Rewind 1-33 
completion (tape driver), 4-12 AST, 1-13 


file, C-12 event flag, 1-9, 1-13 
volume, C-6, C-10, C-12 I/O status, 1-13 
RLO2, last-track (disk driver), Size control, C-5 
3-8 Size parameter 
RSXMAC.SML, 1-16 device-specific function 
library, 1-5 (VTDRV), 6-3 
RUBOUT (printer driver), 5-5 disk driver, 3-3, 3-5 
RUBOUT character I0.CCO function (TTDRV), 2-16 
erase, 2-9, 2-32 IO.EIO function (TTDRV), 2-19 
in escape sequence, 2-69 IO.GTS function (TTDRV), 2-26 
IO.RPR function (TTDRV), 2-35 IO.RAL function (TTDRV), 2-29 
IO.RST function (TTDRV), 2-37 IO.RNE function (TTDRV), 2-31 
TF.RST, 2-30 IO.RPR function (TTDRV), 2-34 
RUBOUT key, 2-66 IO.RST function (TTDRV), 2-38 
backslash echo, 2-66 IO.RTT function (TTDRV), 2-40 
RX02 media, 3-9 I0.STC function (tape driver), 
4-4 
IO.WAL function (TTDRV), 2-41 
SE.ATA error return, 2-61 IO.WBT function (TTDRV), 2-45 
SE.BIN error return, 2-61 SF.GMC function (TTDRV), 2-46 
SE.FIX status return, 2-61 SF.SMC function (TTDRV), 2-55 
SE.IAA error return, 2-61 standard function (printer 
SE.NAT error return, 2-61 driver), 5-2 
SE.NIH error return, 2-61 standard function (tape driver), 
VTDRV, 6-8, 6-9 4-3 
SE.NSC error return, 2-62 TTDRV, 2-6 
SE.SPD error return, 2-62 Space operation (disk driver), 
SE.UPN error return, 2-62 4-11 
SE.VAL error return, 2-62 Spacing record, C-12 
SE.xxx local definition (TTDRV), SPCIOS macro, 1-7 
2-26 , Stadd parameter 


Secondary pool (FI11ACP), C-5 
Seek overlap (disk driver), 3-4 
Select error 
tape driver, 
TK50, 4-9 
Select recovery (tape driver), 
4-9 
Send XOFF 
IO.EIO 
IO. RAL 
IO. RNE 
IO.RPR 
IO.RST 
Set 
multiple characteristic 
SF.SMC, 2-54 
multiple characteristic (VTDRV), 
6-3 . 
terminal characteristic (VTDRV), 
6-2 
SET TERM/AUTOBAUD command, 
SF.GMC function 
I/O status block (TTDRV), 
TTDRV, 2-46 
VTDRV, 6-2, 
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device-specific function 
(VTDRV), 6-3 
disk driver, 3-3, 3-5 
I0.CCO function (TTDRV), 
IO.EIO function (TTDRV), 
IO0.GTS function (TTDRV), 
IO.RAL function (TTDRV), 
IO.RNE function (TTDRV), 
IO.RPR function (TTDRV), 
IO.RST function (TTDRV), 2-38 
IO.RTT function (TTDRV), 2-40 
IO.STC function (tape driver), 
4-4 
IO.WAL function 
IO.WBT function 
SF.GMC function (TTDRV), 2-46 
SF.SMC function (TTDRV), 2-55 
standard function (printer 
driver), 5-2 
standard function (tape driver), 
4-3 
TTDRV, 
Stall I/0 
RC25, 3-9 
delay, 
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2-31 
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Stall I/O 
RC25 (Cont.) 
performance, 3-9 
Stat parameter 
device-specific function 
(VTDRV), 6-3 
Statistics block, C-4 
Status 
off-line (tape driver), 4-12 
on-line (tape driver), 4-12 
second word (tape driver), 4-9 
second word, information, 4-9 
tape transport (tape driver), 
word (F1L1ACP), C-7 
word (tape driver), 4-8 
Status code 
directive, B-5 
I/O, B-1 
numeric, B-l 
swl parameter 
I0.STC function (VTDRV), 6-5 
TTDRV, 2-58 
Status return, 2-58 
disk driver, 3-5 
I0.S’C function (VTDRV), 6-5 
printer driver, 5-3 
tape driver, 4-6 
TU58, 4-16 
VTDRV, 6-7 
Storage, insufficient (VTDRV), 
6-8 
STSES macro, 1-10 
Subfunction 
allowed (TTDRV), 2-12 
Logical OR, 2-7, 2-11 
Subfunction bits (TTDRV), 2-7 
Success code 
directive, B-7 
Successful completion 
TU58, 4-16 
VTDRV, 6-8 
Swl parameter 
device-specific function 
(VTDRV), 6-3 
I0o.STC function (VTDRV), 6-5 
Sw2 parameter 
IO0.STC function (VTDRV), 6-5 
Switch character, 2-57 
entering, 2-57 
specifying, 2-57 
Symbol 
local definition (TTDRV), 2-26 
Synchrenous System Trap 
See SST 
System library device, 1-19 
System Macro Library, 1-5, 1-9, 
1-13, 1-16 
System overhead (TF.RPR), 2-9 
System trap, 1-10 


T.UNKO, 2-51 
T.XXXX 
local definition (TTDRV), 2-26 
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T.xxxx (Cont.) 
terminal type values (VTDRV), 
2-51 
Table parameter 
IO.RTT function (TTDRV), 2-40 


’ Table parameter (TTDRV), 2-6 


Tape mark (tape driver), 4-11 
Task 
abort (printer driver), 5-6 
aborting (tape driver), 4-ll 
blocked, 1-10 
buffering, 2-74 
checkpointable 
buffering, 2-74 
checkpointing, 2-9 
event driven, 1-12 
execution interrupting, 1-10 
execution suspending, 1-22 
offspring 
completion status (VTDRV), 
6-4 
request cancel (VTDRV), 6-9 
tmo parameter (VTDRV), 6-4 
vfc parameter (VTDRV), 6-4 
offspring (VTDRV), 6-1 
register, restoring, 1-12 
register, saving, 1-12 
TC. 8BC 
IO.RST function (TTDRV), 2-38 
IO.RTT function (TTDRV), 2-39, 
2-40 
pass 8 bits, 2-32, 2-35 
SF.GMC function (TTDRV), 2-51 
TC.ABD 
modem support, 2-75 
SF.GMC function (TTDRV), 2-47 
TC.ACD, SF.GMC function (TTDRV), 
2-47 
TC.ACR, SF.GMC function (TTDRV), 
2-47 
TC.ANI, SF.GMC function (TTDRV), 
2-47 
TC.ASP 
modem support, 2-75 
SF.GMC function (TTDRV), 2-47 
terminal speed, 2-52 
TC.AVO, SF.GMC function (TTDRV), 
2-47 
TC.BIN 
IO.RTT function (TTDRV), 2-39 
SF.GMC function (TTDRV), 2-47 
TC.BLK, SF.GMC function (TTDRV), 
2-47 
TC.CTS 
resume output 
SF.SMC function (TTDRV), 2-54 
return suppress state (TTDRV), 
2-53 
return suspend state (TTDRV), 
2-53 
SF.GMC function (TTDRV), 2-47 
suspend output 
SF.SMC function (TTDRV), 2-54 
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TC.DEC, SF.GMC function (TTDRV), 
2-47 
TC.DLU 
modem support, 2-75 
SF.GMC function, 2-47 
TC.EDT, SF.GMC function (TTDRV), 
2-47 
TC.EPA, SF.GMC function (TTDRV), 
2-48 
TC.ESQ, SF.GMC function (TTDRV), 
2-48 
TC.FDX 
characteristic (VTDRV), 6-6, 
SF.GMC function, 2-48 
TC.HFE, SF.GMC function (TTDRV), 
2-48 
TC.HFL, SF.GMC function (TTDRV), 
2-48 
TC.HHT, SE.GMC function (TTDRV), 
2-48 
TC.HLD 
setting effect, 2-57 
SF.GMC characteristic, 2-48 
TC.HSY, SF.GMC function (TTDRV), 
TC.ICS, SF.GMC function (TTDRV), 
2-48 
TC.ISL, SF.GMC function (TTDRV), 
2-48 
TC.LPP, SF.GMC function (TTDRV), 
2-49 
TC.MHU 
buffer, 2-55 
SF.GMC characteristic, 2-49 
special processing, 2-55 
TC.NBR, SF.GMC function (TTDRV), 
2-49 
TC.NEC, SF.GMC function (TTDRV), 
2-49 
TC.OOB 
buffer, 2-56 
SF.GMC characteristic, 2-49 
special processing, 2-56 
TC.PAR, SF.GMC function (TTDRV), 
2-49 
TC.PPT, SF.GMC function (TTDRV), 
2-49 
TC.PRI, SF.GMC function (TTDRV), 
2-49 
TC.PTH 
disable control characters, 
2-21 
pass CTRL/O as normal, 2-63 
SF.GMC function, 2-49 


TC.RAT, SF.GMC function (TTDRV), 


2-49 
TC.RGS, SE.GMC function (TTDRV), 
2-49 
TC.RSP 
SF.GMC characteristic, 2-49 
terminal speed, 2-52 
TC.SCP 
characteristic (VTDRV), 6-7 
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TC.SCP (Cont.) 
SF.GMC function, 2-49 
TC.SFC, SFE.GMC function (TTDRV), 
2-49 
TC.SLV, SF.GMC function (TTDRV), 
2-49 
TC.SMR 
characteristic (VTDRV), 6-7 
_ setting effect, 2-57 
“ SG.GMC function (TTDRV), 2-50 
TC.SSC 
buffer, 2-56 
setting effect, 2-57 
SF.GMC function (TTDRV), 2-50 
special processing, 2-56 
TC.TBF 
flush with TC.TBF, 2-54 
SF.GMC function (TTDRV), 2-50 
unprocessed characters, 2-53 
TC.TBM, SF.GMC function (TTDRV), 
2-50 
TC.TBS, SF.GMC function (TTDRV), 
2-50 
TC.TLC 
CLI setup, 2-65 
SF.GMC function (TTDRV), 2-50 
TC.TMM, SF.GMC function (TTDRV), 
2-50 
TC.TPP, terminal type values, 
2-51 
TC.TSY 
CTRL/Q, 2-64 
CTRL/S, 2-64 
SF.GMC function (TTDRV), 2-50 
TC.TTP 
characteristic (VTDRV), 6-7 
SF.GMC function (TTDRV), 2-47, 
2-50 
TTDRV action, 2-52 
Pergo eres function (TTDRV), 
-5 
TC.WID, SF.GMC function (TTDRV), 
2-51 
TC.XSP 
SF.GMC function (TTDRV), 2-51 
terminal speed, 2-52 
TC.xxx local definition (TTDRV), 
2-26 
Terminal 
attaching (TTDRV), 2-13 
AST, 2-13 
characteristic 
get multiple, 2-46 
set multiple, 2-54 
characteristic (VTDRV), 6-7 
characteristic error (VTDRV), 
6-8 
control character, 2-62 
detached 
buffer flush, 2-73 
disconnecting, 2-28 
input 
checkpointing, 2-76 
line length, 2-2 
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Terminal 


(Cont. ) 


multiple monitoring, 2-8 


pseudo-input, 


Slaved 
unsolicited input, 
support 


get, 
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1-19 


IO0.GTS information, 


type 


values 


(TC. TTP); 


unread output 


reception rate, 


transmission rate, 


widti, 
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Terminal driver 
See TTDRV 
Terminator 
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no 


Special, 
special, 2 
table, 
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contents, 
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Size, 
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item 
with 

TF.RES 
with 


IO.EIO 
IO.RPR 


2-35 
subfunction, 


IO.EIO 
IO.WAL 
IO.WBT 


subfunction, 


IO.ATA 


subfunction, 


IO.ATA 
IO.ATT 


subfunction, 


CTRL/OQ, 
CTRL/R, 
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ESC key, 


IO.EIO 
IO.RNE 
IO.RPR 
IO.RST 
IO.RTT 
RETURN 
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2-7 
function, 
function, 
function, 
2-7 
function, 
2-7 
function, 
function, 
2-8 
2-64 
2-64 
2-64 
2-64 
2-64 
2-64 
2-66 
function, 
function, 
function, 
function, 
function, 
key, 2-66 
2-8 
control, 
function, 
function, 
function, 
function, 
2-8 
2-24 
function, 
2-8 
function, 


2-14 


2-27 
2-51 


2-57 


2-57 


2-19 
2-32 
2-35 
2-38 
2-40 


2-75 
2-20 
2-40 
2-42 
2-45 


2-20 


2-20 


INDEX 


TF.RLB 
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TF.RLU 
with 

TF.RNE 
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TE.RNF 
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with 
TF.RNO 
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TF.RPR 
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system overhead, 
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with 
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TF.RST 
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subfunction, 2-8 
list l, 2-23 

IO.EIO function, 
subfunction, 2-8 
IO.EIO function, 
subfunction, 2-8 
IO.EIO subfunction, 
IO.RAL function, 2-30 
IO.RPR function TTDRV, 
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IO.RST function, 2-38 
subfunction, 2-8 
CTRL/R, 2-64 
DELETE, 2-66 
RUBOUT, 2-66 
subfunction 
IO.RTT function, 
subfunction, 2-9 
list 1, 2-23, 2-24 
2-9 
IO.EIO function, 
subfunction, 2-9 
CTRL/U, 2-64 
CTRL/X, 2-64 
CTRL/Z, 2-64 

ESC key, 2-66 
IO.EIO function, 
RETURN key, 2-66 
subfunction, 2-9 
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2-64 
2-64 


CTRL/R, 
CTRL/U, 
CTRL/X, 2-64 
CTRL/Z, 2-64 
IO.EIO function, 
IO.RAL function, 
IO.RNE function, 
IO.RPR function, 
subfunction, 2-10 
list l, 2-24 
IO.EIO function, 
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2-30 
2-32 
2-35 
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IO.EIO!ITF.RLB function, 
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subfunction, 2-10 
list 1, 2-23 
IO.EIO function, 
IO.RAL function, 
IO.RNE function, 
IO.RPR function, 
IO.RST function, 
subfunction, 2-10 
IO.EIO function, 
subfunction, 2-10 
IO.CCO function, 
IO.EIO function, 
IO.WBT function, 
subfunction, 2-10 
IO.CCO function, 
IO.EIO function, 
IO.WAL function, 
subfunction, 2-11 
IO.EIO function, 


2-21 
2-30 
2-32 
2-36 
2-38 


2-22 
2-17 
2-22 
2-45 
2-17 
2-22 
2-43 


2-22 


2-20 


(TTDRV) , 
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TF.WLB subfunction, 2-11 TTSYNC 
item list 2, 2-25 ‘CTRL/S, 2-64 
with IO.EIO function, 2-18 TUS58 device, 4-13 
TF.XCC subfunction, 2-11 TUS58 driver 
with IO.ATA function, 2-15 I/O function summary, A-1 
with IO.ATT function, 2-13 Type-ahead buffer, 2-72 
TF.XOF subfunction, 2-11, 2-30 character echo, 2-73 
ignored, 2-22 character unprocessed, 2-53 
with IO.EIO function, 2-22 CTRL/C, 2-73 
with IO.RAL function, 2-30 CTRL/O, 2-73 
with IO.RNE function, 2-32 CTRL/Q, 2-73 
with IO.RPR function, 2-33, CTRL/S, 2-73 
2-36 CTRL/X, 2-73 
with IO.RST function, 2-38 flush, 2-8 
Time out, 2-10 flush with TC.TBF, 2-54 
error (TU58), 4-16 storing character, 2-72 
interval, 2-10 
IO.EIO function (TTDRV), 2-21 UIC 
IO.RAL function (TTDRV), 2-30 file owner, C-3 
IO.RNE function (TTDRV), 2-32 UMDIOS macro diagnostic, 1-32 
IO.RPR function (TTDRV), 2-36 Unattached device (tape driver), 
IO.RST function (TTDRV), 2-38 4-7 
IO.RTT function (TTDRV), 2-40 Undate mode, C-6 
TK25 device, 4-1 Unlabeled tape, C-1l 
TKS50O device, 4-1 Unlock block, C-9 
Tmo parameter Unsolicited input, 2-2 
device-specific function buffer full, 2-51 
(VTDRV), 6-3 character AST, 2-7 
IO.RAL function (TTDRV), 2-29 CTRL/C, 2-65 
IO.RNE function (TTDRV), 2-31 notification 
IO.RPR function (TTDRV), 2-34 IO.ATA function, 2-15 
IO.RST function (TTDRV), 2-38 notifying, 2-7 
IO.RTT function (TTDRV), 2-40 slaved terminal, 2-14 
TTDRV, 2-6, 2-10 Update mode, C-10 
Trap, 1-11 
asynchronous, 1-11 VBN 
See also AST high, C-10 
synchronous, 1-11 low, C-10 
See also SST VCK reset 
Trap-dependent parameter, 1-12 I/O sequence (tape driver), 
Truncate 4-12 
file, C-8 VCK status (tape driver), 4-12 
size, C-~8 Version number (FIL1ACP), C-6 
Truncation Vertical format control 
print line, 5-6 See VFC 
TSVO5 device, 4-1 See Vfc parameter 
TTDRV VEC 
allowed subfunction, 2-12 S$, 2-70 
CLI operation, 2-65 +, 2-70 
device support, 2-1 0, 2-70 
device-specific function, 2-12 1, 2-70 
device-specific QIOS, 2-12 blank, 2-70 
features, 2-1 character, 2-70 
I/O function summary, A-3 character (printer driver), 5-4, 
I/O subfunction summary, A-3 5-5 
introduction, 2-1 double space (printer driver), 
specific QIOS 5-5 
brief, 2-3, 2-4 internal vertical format 
standard function, 2-12 (printer driver), 5-5 
standard QIO IO.CCO function (TTDRV), 2-70 
brief, 2-3, 2-4 IO.RPR function (TTDRV), 2-70 
TTSYMS IO.WBT function (TTDRV), 2-70 
using .MCALL with, 2-26 IO.WLB function (TTDRV), 2-70 


IO.WVB function (TTDRV), 2-70 
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VFC (Cont.) 
null, 2-70 


overprint (printer driver), 5-5 


page eject (printer driver), 
5-5 

prompting output (printer 
driver), 5-5 

Single space (printer driver), 
5-5 

Vfc parameter 

device-specific function 
(VTDRV), 6-3 

IO.CCO function (TTDRV), 2-16 

IO.RPR function (TTDRV), 2-34 

IO.WAL function (TTDRV), 2-42 

IO.WBT function (TTDRV), 2-45 

item list 2, 2-25 

Standard function (printer 
driver), 5-3 


TTDRV, 2-6 
Virtual address (disk driver), 
3-3 


Virtual block 
read, C-9, C-10 
read (VTDRV), 6-4 
write, C-9 
write (VTDRV), 6-4 
Virtual I/O, 1-3 
Virtual terminal driver 
See VTDRV 
Volume 
closing, C-12 
foreign mounted (disk driver), 
3-3 
position, C-1l 
position at beginning, C-11 
reinitializing, C-1l 
rewinding, C-6, C-10 
Volume check 
See VCK 
VTDRV, 6-1 
I/O function summary, A-4 


Wildcard context (FIl1ACP), C-7 
Window 

size, C-5 

size (FL1ACP), C-5 

turn, C-5 
Wraparound, 2-71 

IO.WAL function (TTDRV), 2-41 
Write 

attribute control list, C-8 

attribute list, C-8 
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Write (Cont.) 
logical, 1-29 
TUS58, 4-15 
virtual, 1-30 
Write all bits 
I0.CCO function (TTDRV), 2-17 
IO.EIO function (TTDRV), 2-22 
IO.WBT function (TTDRV), 2-45 
Write all characters 
IO.WBT function (TTDRV), 2-45 
TTDRV, 2-10 
Write breakthrough 
IO.CCO function (TTDRV), 2-17 
IO.EIO function (TTDRV), 2-22 
IO.WAL function (TTDRV), 2-43 
IO.WBT function (TTDRV), 2-44 
TTDRV, 2-10, 2-44 
with write breakthrough (TTDRV), 
2-44 
Write input redisplayed 
IO.EIO function (TTDRV), 2-22 
TTDRV, 2-11 
Write logical block 
pass all (TTDRV), 2-41 
TTDRV, 2-7, 2-11, 2-16, 2-19, 
2-41, 2-42, 2-44, 2-45 
VTDRV, 6-4 
Write pass all (TTDRV), 2-7 
Write pass all bits 
IO.WAL function (TTDRV), 2-41 
Write virtual block, C-9 
VTDRV, 6-4 
Write-check 
driver initiate, C-6 
Write-lock 
tape driver, 4-8 
TU58, 4-16 
WTSES macro, 1-15, 1-22 
efn, 1-23 
example, 1-10 
purpose, 1-10 
syntax, 1-22 


XOFF, 2-9, 2-11 
IO.EIO function (TTDRV), 2-21 
send, 2-11 
IO.EIO function (TTDRV), 2-22 
IO.RAL function (TTDRV), 2-30 
IO.RNE function (TTDRV), 2-32 
IO.RPR function (TTDRV), 2-36 
IO.RST function (TTDRV), 2-38 
XON, 2-9 
IO.EIO function (TTDRV), 2-21 
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